Revertir anulación de nota de crédito

POST/api/v1/notas-credito/:notaCreditoId/revertir-anulacion

Reactiva una nota anulada de los sectores 24 o 47. Requiere X-API-Key con permiso notascredito.revertiranulacion y acceso a la misma empresa, ambiente, modalidad, sucursal y punto de venta.

Header requerido X-API-KeyVer operaciones de Notas de crédito

Contrato de la operación

Reactiva una nota anulada de los sectores 24 o 47. Requiere X-API-Key con permiso notas_credito.revertir_anulacion y acceso a la misma empresa, ambiente, modalidad, sucursal y punto de venta.

Solicitud

notaCreditoId es el UUID de la nota anulada. No se envía cuerpo.

Idempotency-Key es opcional; si la envías, debe ser un UUID v4. Repite la solicitud con la misma clave para recuperar el resultado; usarla para otra nota devuelve 409. Sin clave también se deduplican operaciones simultáneas sobre una misma nota.

Resultado

HTTP	Estado	Comportamiento
`200`	`aceptado`	La reversión fue confirmada. La factura original no cambia. La respuesta puede incluir `codigoRecepcionReversion` y `revertidaEn`; conserva el historial de anulación.
`202`	`reversion_pendiente`	El resultado todavía no está confirmado. La nota se considera anulada y su importe permanece reservado. Repite la misma solicitud y conserva la clave si la enviaste.

El PDF y el QR mantienen el estado anulado mientras la reversión esté pendiente. Cuando la reversión se confirma, la respuesta vuelve a incluir los enlaces de la nota aceptada.

409 indica estado incompatible o saldo insuficiente para reactivar la nota porque otras notas ya consumieron el importe liberado. 422 indica un rechazo explícito; la nota permanece anulado y el importe deja de reservarse. Tras un rechazo, corrige el problema antes de intentar de nuevo.

Ejemplo

Solicitud de ejemplo

Clave ficticia; no se ejecuta desde esta página

cURL · POST

export FALMUS_API_URL='https://api.falmus.com/api/v1'
export FALMUS_API_KEY='flm_test_REEMPLAZA_CON_TU_CLAVE'
export NOTA_CREDITO_ID='REEMPLAZA_CON_NOTA_CREDITO_ID'

curl --request POST \
  --url "$FALMUS_API_URL/notas-credito/${NOTA_CREDITO_ID}/revertir-anulacion" \
  --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

200 OKapplication/json

JSON

{
  "message": "anulación de nota de crédito revertida correctamente",
  "data": {
    "id": "00000000-0000-4000-8000-000000000001",
    "facturaId": "00000000-0000-4000-8000-000000000042",
    "nroNota": 1,
    "cuf": "B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF01",
    "codigoRecepcion": "00000000-0000-4000-8000-000000000043",
    "codigoEstado": 908,
    "estado": "aceptado",
    "fechaEmision": "2026-08-30T16:10:00-04:00",
    "montoTotalOriginal": 500,
    "montoTotalDevuelto": 100,
    "montoEfectivoCredito": 13,
    "codigoPuntoVenta": 0,
    "codigoDocumentoSector": 24,
    "urlQr": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=123456789&cuf=B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF01&numero=1&t=2",
    "urlXml": "https://api.example.test/api/v1/public/notas-credito/B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF01/xml",
    "urlPdf": "https://api.example.test/api/v1/public/notas-credito/B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF01/pdf",
    "creadoEn": "2026-08-30T16:10:00-04:00",
    "actualizadoEn": "2026-08-30T16:10:00-04:00",
    "codigoRecepcionAnulacion": "anulacion-siat-demo",
    "anuladaEn": "2026-08-30T16:10:00-04:00",
    "codigoRecepcionReversion": "reversion-siat-demo",
    "revertidaEn": "2026-08-30T16:10:00-04:00"
  }
}

Datos ficticios; los identificadores y valores cambian en cada respuesta.

202 Accepted

La nota sigue anulada mientras se confirma la reversión. Su importe permanece reservado; repite la misma solicitud y conserva la clave si la enviaste.

JSON

{
  "message": "reversión de nota de crédito pendiente de confirmación",
  "data": {
    "id": "00000000-0000-4000-8000-000000000001",
    "facturaId": "00000000-0000-4000-8000-000000000042",
    "nroNota": 1,
    "cuf": "B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF01",
    "codigoRecepcion": "00000000-0000-4000-8000-000000000043",
    "codigoEstado": 905,
    "estado": "reversion_pendiente",
    "fechaEmision": "2026-08-30T16:10:00-04:00",
    "montoTotalOriginal": 500,
    "montoTotalDevuelto": 100,
    "montoEfectivoCredito": 13,
    "codigoPuntoVenta": 0,
    "codigoDocumentoSector": 24,
    "urlQr": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=123456789&cuf=B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF01&numero=1&t=2",
    "urlXml": "https://api.example.test/api/v1/public/notas-credito/B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF01/xml",
    "urlPdf": "https://api.example.test/api/v1/public/notas-credito/B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF01/pdf",
    "creadoEn": "2026-08-30T16:10:00-04:00",
    "actualizadoEn": "2026-08-30T16:10:00-04:00",
    "codigoMotivoAnulacion": 1
  }
}

Volver a Notas de crédito