Obtener detalle de factura emitida

GET/api/v1/facturas/:facturaId

Recupera una factura emitida de la empresa asociada a la X-API-Key. Requiere facturas.consultar. facturaId debe ser el UUID devuelto al emitir o listar; una factura de otra empresa responde como no encontrada.

Header requerido X-API-KeyVer operaciones de Facturas

Contrato de la operación

Recupera una factura emitida de la empresa asociada a la X-API-Key. Requiere facturas.consultar. facturaId debe ser el UUID devuelto al emitir o listar; una factura de otra empresa responde como no encontrada.

Responde 200, 401, 403 o 404. Incluye datos fiscales de la factura y sus detalles, pero no devuelve secretos SIAT, certificado, CUIS, CUFD ni XML firmado.

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 FACTURA_ID='REEMPLAZA_CON_FACTURA_ID'

curl --request GET \
  --url "$FALMUS_API_URL/facturas/${FACTURA_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": "factura obtenida correctamente",
  "data": {
    "id": "00000000-0000-4000-8000-000000000001",
    "numeroFactura": 42,
    "cuf": "A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0",
    "codigoRecepcion": "00000000-0000-4000-8000-000000000042",
    "codigoEstado": 908,
    "estado": "aceptado",
    "ambiente": "pruebas",
    "fechaEmision": "2026-08-30T16:10:00-04:00",
    "montoTotal": 500,
    "codigoPuntoVenta": 0,
    "codigoDocumentoSector": 1,
    "nombreDocumentoSector": "Compra y venta",
    "urlQr": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=123456789&cuf=A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0&numero=42&t=2",
    "urlXml": "https://api.example.test/api/v1/public/facturas/A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0/xml",
    "urlPdf": "https://api.example.test/api/v1/public/facturas/A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0/pdf",
    "cliente": {
      "codigoTipoDocumento": 5,
      "numeroDocumento": "99001",
      "razonSocial": "CLIENTE DE DEMOSTRACIÓN",
      "codigoCliente": "CLI-99001"
    },
    "pago": {
      "codigoMetodoPago": 1
    },
    "datosSector": {
      "codigoMoneda": 1,
      "tipoCambio": 1
    },
    "detalles": [
      {
        "actividadEconomica": "6201000",
        "codigoProductoSin": 1003914,
        "descripcion": "Servicio de demostración",
        "cantidad": 1,
        "codigoUnidadMedida": 58,
        "precioUnitario": 500
      }
    ]
  }
}

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

Volver a Facturas