Obtener nota de crédito

GET/api/v1/notas-credito/:notaCreditoId

Obtiene una nota por UUID y limita la consulta a la empresa de X-API-Key. Requiere facturas.consultar.

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

Contrato de la operación

Obtiene una nota por UUID y limita la consulta a la empresa de X-API-Key. Requiere facturas.consultar.

Incluye cliente, detalles originales y devueltos, montos del ajuste, estado SIAT, URL QR y PDF público. Los enlaces sólo aparecen para notas aceptadas; no se expone una URL XML. No expone token, CUIS, CUFD ni certificado.

json

{"message":"nota de crédito obtenida correctamente","data":{"id":"00000000-0000-4000-8000-000000000001","facturaId":"00000000-0000-4000-8000-000000000001","numeroNota":1,"cuf":"CUF-NOTA","codigoRecepcion":"recepcion-siat","codigoEstado":908,"estado":"aceptado","fechaEmision":"2026-08-30T17:00:00-04:00","montoTotalOriginal":500,"montoTotalDevuelto":250,"montoEfectivoCredito":32.5,"codigoPuntoVenta":29,"codigoDocumentoSector":24,"varianteDocumento":"credito_debito","urlQr":"https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=123456789&cuf=CUF-NOTA&numero=1&t=2","urlPdf":"https://api.example.test/api/v1/public/notas-credito/CUF-NOTA/pdf","cliente":{"codigoTipoDocumento":5,"numeroDocumento":"99001","razonSocial":"CLIENTE DEMO","codigoCliente":"CLIENTE-99001"},"tipoNota":"CREDITO","codigoMetodoPago":1,"montoDescuentoCreditoDebito":0,"detalles":[{"nroItem":1,"actividadEconomica":"6201000","codigoProductoSin":1003914,"codigoProducto":"1003914","descripcion":"Servicio","cantidad":2,"codigoUnidadMedida":58,"precioUnitario":250,"montoDescuento":0,"subtotal":500,"codigoDetalleTransaccion":1},{"nroItem":2,"actividadEconomica":"6201000","codigoProductoSin":1003914,"codigoProducto":"1003914","descripcion":"Devolución parcial - Servicio","cantidad":1,"codigoUn...

Ejemplo

Solicitud de ejemplo

Clave ficticia; no se ejecuta desde esta página

cURL · GET

export FALMUS_API_URL='https://staging-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 GET \
  --url "$FALMUS_API_URL/notas-credito/${NOTA_CREDITO_ID}" \
  --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": "nota de crédito obtenida correctamente",
  "data": {
    "id": "00000000-0000-4000-8000-000000000001",
    "facturaId": "00000000-0000-4000-8000-000000000042",
    "numeroNota": 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,
    "varianteDocumento": "credito_debito",
    "urlQr": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=123456789&cuf=B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF01&numero=1&t=2",
    "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",
    "cliente": {
      "codigoTipoDocumento": 5,
      "numeroDocumento": "99001",
      "razonSocial": "CLIENTE DE DEMOSTRACIÓN",
      "codigoCliente": "CLI-99001"
    },
    "tipoNota": "CREDITO",
    "codigoMetodoPago": 1,
    "montoDescuentoCreditoDebito": 0,
    "detalles": [
      {
        "nroItem": 1,
        "actividadEconomica": "6201000",
        "codigoProductoSin": 1003914,
        "codigoProducto": "PROD-001",
        "descripcion": "Servicio de demostración",
        "cantidad": 1,
        "codigoUnidadMedida": 58,
        "precioUnitario": 100,
        "montoDescuento": 0,
        "subtotal": 100,
        "codigoDetalleTransaccion": 1
      }
    ]
  }
}

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

Volver a Notas de crédito