Cerrar punto de venta
/api/v1/sucursales/:branchId/puntos-venta/:pointOfSaleCode/cerrarSolicita el cierre ante SIAT y sólo cambia el estado local a cerrado cuando el servicio oficial lo confirma.
X-API-KeyVer operaciones de Sucursales y puntos de venta Contrato de la operación
Solicita el cierre ante SIAT y sólo cambia el estado local a cerrado cuando el servicio oficial lo confirma.
Requiere X-API-Key con permiso sucursales.administrar. branchId es el UUID de la sucursal de la empresa autenticada y pointOfSaleCode es el código numérico asignado por SIAT; el código 0 no puede cerrarse. No envíes Bearer, X-Tenant-ID, Idempotency-Key, CUIS ni Token Delegado.
200 OK confirma el cierre. 400 indica UUID o código inválido; 404, sucursal o punto inexistente para la empresa; 409, cierre concurrente; 422, rechazo SIAT o integración no disponible para esa sucursal; 503, fallo temporal.
Ejemplo
Solicitud de ejemplo
export FALMUS_API_URL='https://staging-api.falmus.com/api/v1'
export FALMUS_API_KEY='flm_test_REEMPLAZA_CON_TU_CLAVE'
export BRANCH_ID='REEMPLAZA_CON_BRANCH_ID'
export POINT_OF_SALE_CODE='REEMPLAZA_CON_POINT_OF_SALE_CODE'
curl --request POST \
--url "$FALMUS_API_URL/sucursales/${BRANCH_ID}/puntos-venta/${POINT_OF_SALE_CODE}/cerrar" \
--header "X-API-Key: $FALMUS_API_KEY"Este ejemplo no incluye un cuerpo. Revisa el contrato para conocer los parámetros de ruta y consulta.
Respuesta
Ejemplo de respuesta
application/json{
"message": "punto de venta cerrado correctamente",
"data": {
"id": "00000000-0000-4000-8000-000000000022",
"codigoPuntoVenta": 29,
"nombre": "Caja principal",
"estado": "cerrado",
"creadoEn": "2026-08-20T09:00:00-04:00",
"actualizadoEn": "2026-08-30T16:10:00-04:00"
}
}Datos ficticios; los identificadores y valores cambian en cada respuesta.