Skip to content

Listado Facturas

Método para ver todas las facturas en una lista, se debe enviar los parámetros por query.

GET https://sandbox.cucu.bo/api/v1/invoice/pagination?posId={posId}&docSector={docSector}&page={page}&size={size}
ParámetroTipoRequeridoDescripciónPetición
posIdIntSiId asignado a punto de ventaReq
branchIdIntNoId asignado a una sucursalReq
docSectorIntNoCódigo documento sectorReq
pageIntSiNúmero de página (default 0)Req / Res
sizeIntNoNúmero de items en página (default 10)Req / Res
totalItemsStringNúmero de items totalesRes
totalPagesStringNúmero de páginas disponiblesRes
limitStringLímite de items por página de acuerdo al sizeRes
prevPageStringPágina anterior, en caso de superar el límite de página devuelve nuloRes
nextPageStringPágina siguiente, en caso de superar el límite de página devuelve nuloRes
resultStringItems de facturas en formato arrayRes

Response

json
{
  "message": "COMPLETED",
  "errors": null,
  "success": true,
  "data": {
    "totalItems": 8,
    "totalPages": 2,
    "limit": 4,
    "page": 1,
    "prevPage": 0,
    "nextPage": null,
    "result": [
      {
        "invoiceNumber": 6,
        "code": "D6A0D688",
        "qrCode": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=6822046012&cuf=1D2C888524A5306B1BECF34A7439337C4DDF109A7C15F3E0ED2810EC74&numero=6&t=1",
        "urlInvoice": "https://sandbox.cucu.bo/pdf?code=D6A0D688",
        "siatCodeState": 690,
        "typeDocSector": 1
      },
      {
        "invoiceNumber": 7,
        "code": "C0F61919",
        "qrCode": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=6822046012&cuf=1D2C888524A59B39110E9EF90EE3BD3179AC6A72E6774FE3A62A316D74&numero=7&t=1",
        "urlInvoice": "https://sandbox.cucu.bo/pdf?code=C0F61919",
        "siatCodeState": 908,
        "typeDocSector": 1
      },
      {
        "invoiceNumber": 8,
        "code": "4D99CACA",
        "qrCode": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=6822046012&cuf=1D2C888524A59B3945E4188FDC312BF309102A8B50774FE3A62A316D74&numero=8&t=1",
        "urlInvoice": "https://sandbox.cucu.bo/pdf?code=4D99CACA",
        "siatCodeState": 908,
        "typeDocSector": 1
      },
      {
        "invoiceNumber": 9,
        "code": "2A6AA293",
        "qrCode": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=6822046012&cuf=1D2C888524A59B3F51A7C3BF715A4D7331921AA3BA88BDF4A5B1416D74&numero=9&t=1",
        "urlInvoice": "https://sandbox.cucu.bo/pdf?code=2A6AA293",
        "siatCodeState": 908,
        "typeDocSector": 1
      }
    ]
  }
}

Métodos para recuperar una Factura en formatos específicos.

Métodos para recuperar una factura en el formato json, xml y pdf-base64, se debe enviar los parámetros por json.

ParámetroTipoRequeridoDescripciónPetición
posIdIntSiId asignado a punto de ventaReq
branchIdIntNoId asignado a una sucursalReq
invoiceNumberIntSiNúmero de la factura a recuperar.Req
invoiceCodeStringSiCódigo de la factura a recuperarReq

Formato XML

GET https://sandbox.cucu.bo/api/v1/invoice/xml

Request

json
{
  "posId": 1,
  "invoiceNumber": 1026,
  "invoiceCode": "6D1B7B5D"
}

Response

json
{
  "message": "COMPLETED",
  "errors": null,
  "success": true,
  "data": "<facturaElectronicaHospitalClinica xmlns:ns2=\"http://www.w3.org/2000/09/xmldsig#\">\n    <cabecera>\n        </nitEmisor>\n        </razonSocialEmisor>\n        <municipio>LA PAZ</municipio>\n        <telefono>1234567890</telefono>\n        <numeroFactura>1026</numeroFactura>\n        <cuf>1D2C888524A59DAA2579B2FCD6B9C188A88E3220D454499073DD246D74</cuf>\n        <cufd>BQVVCdVU6R0E=Nz0M4OEU3RUM2REY=Qm87Tm9CSERXVUFFEQUQwQzQ5NDNEQ</cufd>\n        <codigoSucursal>0</codigoSucursal>\n        <direccion>Cion>\n        <codigoPuntoVenta>0</codigoPuntoVenta>\n        <fechaEmision>2022-03-06T01:40:31.933</fechaEmision>\n        <nombreRazonSocial>CLINIC TEST</nombreRazonSocial>\n        <codigoTipoDocumentoIdentidad>1</codigoTipoDocumentoIdentidad>\n        <numeroDocumento>234234234</numeroDocumento>\n        <complemento>2K</complemento>\n        <codigoCliente>CLIENT-TEST123</codigoCliente>\n        <modalidadServicio>POST OPERACION</modalidadServicio>\n        <codigoMetodoPago>1</codigoMetodoPago>\n        <numeroTarjeta xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:nil=\"true\"></numeroTarjeta>\n        <montoTotal>220.99</montoTotal>\n        <montoTotalSujetoIva>220.99</montoTotalSujetoIva>\n        <codigoMoneda>1</codigoMoneda>\n        <tipoCambio>1</tipoCambio>\n        <montoTotalMoneda>220.99</montoTotalMoneda>\n        <montoGiftCard>0.0</montoGiftCard>\n        <descuentoAdicional>0.0</descuentoAdicional>\n        <codigoExcepcion xmlns:ce\" xsi:nil=\"true\"></especialidadDetalle>\n        <nroQuirofanoSalaOperaciones>1</nroQuirofanoSalaOperaciones>\n        <especialidadMedico xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:nil=\"true\"></especialidadMedico>\n        <nombreApellidoMedico>DOCTOR PRUEBA</nombreApellidoMedico>\n        <nitDocumentoMedico>1016867023</nitDocumentoMedico>\n        <nroMatriculaMedico xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:nil=\"true\"></nroMatriculaMedico>\n        <nroFacturaMedico xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:nil=\"true\"></nroFacturaMedico>\n        <cantidad>1.0</cantidad>\n        <unidadMedida>58</unidadMedida>\n        <precioUnitario>180.99</precioUnitario>\n        <montoDescuento>0.0</montoDescuento>\n        <subTotal>180.99</subTotal>\n    </detalle>\n    <detalle>\n        <actividadEconomica>620100</actividadEconomica>\n        <codigoProductoSin>83141</codigoProductoSin>\n        <codigoProducto>PRODMED2</codigoProducto>\n        <descripcion>BARBITURICOS</descripcion>\n        <especialidad xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:nil=\"true\"></especialidad>\n        <especialidadDetalle xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:nil=\"true\"></especialidadDetalle>\n        <nroQuirofanoSalaOperaciones>1</nroQuirofanoSalaOperaciones>\n        <especialidadMedico xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:nil=\"true\"></especialidadMedico>\n        <nombreApellidoMedico>DOCTOR PRUEBA</nombreApellidoMedico>\n        <nitDocumentoMedico>1016867023</nitDocumentoMedico>\n        <nroMatriculaMedico xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:nil=\"true\"></nroMatriculaMedico>\n        <nroFacturaMedico xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:nil=\"true\"></nroFacturaMedico>\n        <cantidad>1.0</cantidad>\n        <unidadMedida>58</unidadMedida>\n        <precioUnitario>40.0</precioUnitario>\n        <montoDescuento>0.0</montoDescuento>\n        <subTotal>40.0</subTotal>\n    </detalle>\n<Signature xmlns=\"http://www.w3.org/2000/09/xmldsig#\">\n<SignedInfo>\n<CanonicalizationMethod Algorithm=\"http://www.w3.org/TR/2001/REC-xml-c14n3odSsadqtC3P\nCoGWiUR10cn45cfM/YyxlLNeCv+YatXiRSFEWqcPhnwc/Iz4iiWA8ZNaQX4tkY/EZHusuh89PmXO\nkjnqbY9pIrfn0w6oNCp7HeqarQfW/HU7DWz0K3GtUCzQmJl86/AI4HSNBkSYxGKDkiBv2\nm+sIxtZFh/7tlnGe1FRVWowNeip9GrtVBm4gmK9iBbh2WLzg4jdcrSRvGkMPtve5rV0Bq3Vv04cQ\ncInZOjUGLDyoaoYq/dpk1lopG7l3WHLtEQQ\naoaDOD9z9nE4Jsun7tT0HlJrJD3hbE90jnfpFIugojOjyQIwcfweMtGhSyT4RIXLKywqzlJxs6Ev\nEtVGC7EKn+waQhHwI1OhuLwUwucseumXO7c8IqltQQ==\n</X509Certificate>\n</X509Data>\n</KeyInfo>\n</Signature></facturaElectronicaHospitalClinica>"
}

Formato JSON

GET https://sandbox.cucu.bo/api/v1/invoice/json

Request

json
{
  "posId": 1,
  "invoiceNumber": 1026,
  "invoiceCode": "6D1B7B5D"
}

Response

json
{
  "message": "COMPLETED",
  "errors": null,
  "success": true,
  "data": {
    "cabecera": {
      "nitEmisor": 6822046012,
      "razonSocialEmisor": "TEST",
      "municipio": "LA PAZ",
      "telefono": "1234567890",
      "numeroFactura": 1026,
      "cuf": "1D2C888524A59DAA2579B2FCD6B9C188A88E3220D454499073DD246D74",
      "cufd": "BQVVCdVU6R0E=Nz0M4OEU3RUM2REY=Qm87Tm9CSERXVUFFEQUQwQzQ5NDNEQ",
      "codigoSucursal": 0,
      "direccion": "CALLE LAS LOMAS ZONA",
      "codigoPuntoVenta": 0,
      "fechaEmision": 1646545231933,
      "nombreRazonSocial": "CLINIC TEST",
      "codigoTipoDocumentoIdentidad": 1,
      "numeroDocumento": "234234234",
      "complemento": "2K",
      "codigoCliente": "CLIENT-TEST123",
      "modalidadServicio": "POST OPERACION",
      "codigoMetodoPago": 1,
      "numeroTarjeta": null,
      "montoTotal": 220.99,
      "montoTotalSujetoIva": 220.99,
      "codigoMoneda": 1,
      "tipoCambio": 1,
      "montoTotalMoneda": 220.99,
      "montoGiftCard": 0.0,
      "descuentoAdicional": 0.0,
      "codigoExcepcion": null,
      "cafc": null,
      "leyenda": "Ley N° 453: La interrupción del servicio debe comunicarse con anterioridad a las Autoridades que correspondan y a los usuarios afectados.",
      "usuario": "USRTESTB341",
      "codigoDocumentoSector": 17
    },
    "detalle": [
      {
        "actividadEconomica": "620100",
        "codigoProductoSin": 83141,
        "codigoProducto": "PRODMED1",
        "descripcion": "PROTEIGA GOLD WHEY",
        "especialidad": null,
        "especialidadDetalle": null,
        "nroQuirofanoSalaOperaciones": 1,
        "especialidadMedico": null,
        "nombreApellidoMedico": "DOCTOR PRUEBA",
        "nitDocumentoMedico": 1016867023,
        "nroMatriculaMedico": null,
        "nroFacturaMedico": null,
        "cantidad": 1.0,
        "unidadMedida": 58,
        "precioUnitario": 180.99,
        "montoDescuento": 0.0,
        "subTotal": 180.99
      },
      {
        "actividadEconomica": "620100",
        "codigoProductoSin": 83141,
        "codigoProducto": "PRODMED2",
        "descripcion": "BARBITURICOS",
        "especialidad": null,
        "especialidadDetalle": null,
        "nroQuirofanoSalaOperaciones": 1,
        "especialidadMedico": null,
        "nombreApellidoMedico": "DOCTOR PRUEBA",
        "nitDocumentoMedico": 1016867023,
        "nroMatriculaMedico": null,
        "nroFacturaMedico": null,
        "cantidad": 1.0,
        "unidadMedida": 58,
        "precioUnitario": 40.0,
        "montoDescuento": 0.0,
        "subTotal": 40.0
      }
    ],
    "signature": null
  }
}

Formato PDF-BASE64

GET https://sandbox.cucu.bo/api/v1/invoice/pdf

Request

json
{
  "posId": 1,
  "invoiceNumber": 44,
  "invoiceCode": "87C6ED47"
}

Response

json
{
  "message": "COMPLETED",
  "errors": null,
  "success": true,
  "data": "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IG4gCjAwMDAwMTM1NTAgMDAwMDAgbiAKMDAwMDAyMTg5OCAwMDAwMCBuIAowMDAwMDAwMzExIDAwMDAwIG4gCjAwMDAwMDMzNTAgMDAwMDAgbiAKMDAwMDAwMzM3MCAwMDAwMCBuIAowMDAwMDAzNDI2IDAwMDAwIG4gCjAwMDAwMDM4MjEgMDAwMDAgbiAKMDAwMDAwNzQ0MiAwMDAwMCBuIAowMDAwMDAzNTk3IDAwMDAwIG4gCjAwMDAwMDM4MDEgMDAwMDAgbiAKMDAwMDAwNzQ2MyAwMDAwMCBuIAowMDAwMDA3NzA2IDAwMDAwIG4gCjAwMDAwMTIzNzkgMDAwMDAgbiAKMDAwMDAxMjc5OCAwMDAwMCBuIAowMDAwMDEyMzU4IDAwMDAwIG4gCjAwMDAwMTM2OTkgMDAwMDAgbiAKMDAwMDAxMzkzNCAwMDAwMCBuIAowMDAwMDIwNDcxIDAwMDAwIG4gCjAwMDAwMjA5NzggMDAwMDAgbiAKMDAwMDAyMDQ1MCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDI2Ci9JbmZvIDEgMCBSCi9Sb290IDExIDAgUgo+PgpzdGFydHhyZWYKMjIxMzcKJSVFT0YK"
}