Factura Servicios Básicos

Método para la emisión de facturas para la distribución de agua, electricidad, Internet o cualquier servicio que se considere básico, de acuerdo a la normativa vigente.

Modalidad Electrónica en Línea

POST https://sandbox.cucu.bo/api/v1/invoice/electronic/basicService

Modalidad Computarizada en Línea

POST https://sandbox.cucu.bo/api/v1/invoice/computarized/basicService

Cabecera de la factura

ParámetroTipoRequeridoDescripciónPetición
posIdIntSiId asignado al punto de venta.Req / Res
branchIdIntNoId sucursal.Req / Res
clientReasonSocialStringSiRazón Social o nombre registrado en el Padrón Nacional de Contribuyentes de la persona o empresa que emite la factura.Req / Res
clientDocumentTypeIntSiAutogenerado desde catálogos por el agrupador 9. (Valor que identifica el Tipo de Documento utilizado para la emisión de la factura).Req / Res
clientNroDocumentStringSiNúmero que corresponde al Tipo de Documento Identidad utilizado y al cual se realizará la facturación.Req / Res
clientCodeStringSiCódigo de identificación único del cliente, deberá ser asignado por el sistema de facturación del contribuyente.Req / Res
paramPaymentMethodIntSiAutogenerado desde catálogos por el agrupador 13. (Valor que identifica el método de pago. Por ejemplo 1 es efectivo).Req / Res
userPosStringSiIdentifica al usuario que emite la factura, deberá ser descriptivo. Por ejemplo JPEREZ.Req / Res
typeInvoiceIntSiTipo de la factura, valores permitidos:
1 = Factura con Derecho a Crédito Fiscal
2 = Factura sin Derecho a Crédito Fiscal
3 = Documento de Ajuste
Req / Res
paramCurrencyIntSiAutogenerado desde catálogos por el agrupador 14. (Valor que identifica la moneda).Req / Res
clientComplementStringNoComplemento de cliente.Req / Res
clientCityStringSiCiudad del cliente.Req / Res
exceptionCodeIntNoValor que se envía para autorizar el registro de una factura con NIT inválido. Enviar uno (1) cuando se autorice el registro.Req / Res
numberCardIntNoCuando el método de pago es 2 (Tarjeta), debe enviarse este valor.Req / Res
giftCardIntNoMonto a ser cancelado con una Gift Card.Req / Res
serviceModeStringNoServicio que se otorga al paciente, por ejemplo: Post Operatorio.Req / Res
nitEmissorIntSiNúmero de NIT registrado en el Padrón Nacional de Contribuyentes que corresponde a la persona o empresa que emite la factura.Res
cufStringSiCódigo único de factura.Res
invoiceNumberIntSiNúmero de factura emitida.Res
qrCodeStringSiCódigo Qr que redirecciona a la pagina de SIAT y su respectiva factura.Res
dateEmissionStringSiFecha y hora en la cual se emite la factura.Res
amountTotalIntSiMonto total por el cual se realiza el hecho generador.Res
amountTotalDiscountIntSiMonto Adicional al descuento por item.Res
amountTotalCurrencyIntSiEs el Monto Total expresado en el tipo de moneda, si el código de moneda es boliviano deberá ser igual al monto total.Res
userCashierStringNoUsuario que esta a cargo del sistema para realizar el proceso de entrega de la factura.Res
siatCodeStateIntSiCódigo de estado.Res
siatCodeReceptionStringSiCódigo de recepción.Res
siatDescriptionStatusStringSiDescripción del estadoRes
countItemsIntSiNúmero de productos.Res
invoiceXmlStringSiXml de la factura.Res
invoiceCodeStringSiCódigo corto de la factura (invoiceCode).Res
clientEmailStringSiEmail del cliente.Req
additionalDiscountIntNoMonto Adicional al descuento por itemReq
invoiceUrlStringSiRuta publica de la factura.Res
meterNumberIntSiNúmero de medidor del cliente al que se le factura, máximo de 100 caracteres.Req
monthIntNoMes correspondiente al periodo por el cual se está facturando el servicio.Req
gestationIntNoCorresponde a la gestión que se está facturando.Req
cityStringNoNombre de la ciudad donde se encuentra el domicilio del cliente al que se le factura.Req
customerAddressStringNoDirección donde se halla ubicado el domicilio.Req
consumptionPeriodIntNoConsumo del servicio en el periodo.Req
beneficiary1886IntNoNúmero de carnet de identidad del beneficiario.Req
discountAmount1886IntNoCampo Referencial - Sumatoria de los montos internos por item cuando se trate de mṕas de un itemReq
amountDiscountDignityRateIntNoCampo Referencial - Sumatoria de los montos internos por item cuando se trate de mṕas de un itemReq
rateSewageIntNoTasa de limpieza.Req
rateLightingIntNoTasa por alumbrado público.Req
rateOthersIntNoSumatoria de otras tasasReq
detailAdjustmentNotTaxArrayNoDetalle en formato json del monto de Ajustes que no esta sujetos al IVA y que se consideran para el calculo del monto a pagar. JSON en formato campo, valor. Ej: [{"campo": valor 1, "campo": valor 2}]Req
detailAdjustmentToTaxArrayNoDetalle en formato json del monto de Ajustes que estan sujetos al IVA y que se consideran para el calculo del monto a pagar. JSON en formato campo, valor. Ej: [{"campo": valor 1, "campo": valor 2}]Req
detailOtherPaymentsNotToTaxArrayNoDetalle en formato json del monto de los otros pagos realizados que no afectan al IVA, pero si al monto a pagar. JSON en formato campo, valor. Ej: [{"campo": valor 1, "campo": valor 2}]Req

Detalle de Factura

ParámetroTipoRequeridoDescripciónPetición
detailInvoiceArraySiDetalle de los productos de la factura.Req / Res
activityEconomicStringSiActividad económica registrada en el Padrón Nacional de Contribuyentes relacionada al NIT.Req / Res
unitMeasureIntSiAutogenerado desde catálogos por el agrupador 17. (Valor que identifica la unidad de medida).Req / Res
codeProductSinStringSiHomologado a los códigos de productos genéricos enviados por impuestos (ver agrupador 1 de catálogos).Req / Res
codeProductStringSiCódigo que otorga el contribuyente a su servicio o producto.Req / Res
descriptionStringSiDescripción que otorga el contribuyente a su servicio o producto.Req / Res
qtyIntSiCantidad del producto o servicio otorgado. En caso de servicio este valor debe ser 1.Req / Res
priceUnitIntSiPrecio que otorga el contribuyente a su servicio o producto.Req / Res
amountDiscountIntNoMonto de descuento sobre el producto o servicio específico, Si no aplica deberá ser nulo.Req / Res
subTotalIntSiEl subtotal es igual a la (cantidad * precio unitario) – descuento.Res

Request

{
  "posId": 1,
  "clientReasonSocial": "TEST-1",
  "clientDocumentType": 5,
  "clientNroDocument": "463432019",
  "clientCode": "CLIENT122",
  "paramPaymentMethod": 1,
  "userPos": "USRTEST-1",
  "typeInvoice": 1,
  "paramCurrency": 1,
  "clientCity": "La Paz",
  "nitSet": 1020703023,
  "clientEmail": "TEST1@gmail.com",
  "month": 1,
  "gestation": 2022,
  "city": "La Paz",
  "meterNumber": 23828382938,
  "customerAddress": "LA PAZ CALLE X ZONAE",
  "consumptionPeriod": 123123,
  "beneficiary1886": 2323123123,
  "discountAmount1886": 10,
  "amountDiscountDignityRate": 10,
  "rateSewage": 10,
  "rateLighting": 10,
  "rateOthers": 10,
  "detailAdjustmentNotTax": {
    "danil1": 10
  },
  "detailAdjustmentToTax": {
    "danil1": 10,
    "danil2": 10
  },
  "detailOtherPaymentsNotToTax": {
    "danil1": 10,
    "danil2": 10
  },
  "detailInvoice": [
    {
      "activityEconomic": "620100",
      "unitMeasure": 62,
      "codeProductSin": 83141,
      "codeProduct": "AWS PACK 1",
      "description": "PRODUCTO DE PRUEBA 1",
      "qty": 1,
      "priceUnit": 700
    }
  ]
}

Response

{
  "message": "COMPLETED_SERVICE_BASIC",
  "errors": null,
  "success": true,
  "data": {
    "nitEmissor": 6822046012,
    "invoiceCode": "8D0A3ACD",
    "cuf": "1D2C888524A59EF44D23993EF83974195FC1A72FFA50D6A945FCB56D74",
    "invoiceNumber": 425,
    "qrCode": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=6822046012&cuf=1D2C888524A59EF44D23993EF83974195FC1A72FFA50D6A945FCB56D74&numero=425&t=2",
    "invoiceUrl": "/pdf?code=8D0A3ACD8UtcTsX5qNyyWdoxFZWH&client=ZRNDB3MOIG9FWN88RH0X1S49E",
    "dateEmission": "2022-04-13T15:54:34.315",
    "amountTotal": 720.0,
    "amountTotalDiscount": 0.0,
    "amountTotalCurrency": 770.0,
    "userCashier": "USRTESTB341",
    "siatCodeState": 908,
    "siatCodeReception": "8a549d3a-bb63-11ec-89fb-e3c7e1118d10",
    "siatDescriptionStatus": "VALIDADA",
    "countItems": 1,
    "invoiceXml": "<facturaElectronicaServicioBasico xmlns:ns2=\"http://www.w3.org/2000/09/xmldsig#\">\n    <cabecera>\n        <nitEmisor></nitEmisor>\n        <razonSocialEmisor></razonSocialEmisor>\n        <municipio>LA PAZ</municipio>\n        <telefono>78817944</telefono>\n        <numeroFactura>425</numeroFactura>\n        <cuf>1D2C888524A59EF44D23993EF83974195FC1A72FFA50D6A945FCB56D74</cuf>\n        <cufd>BQVVCdVU6R0E=NzDgXVUFFGMjg0MzcyOEYzR</cufd>\n        <codigoSucursal>0</codigoSucursal>\n        <direccion>CAVI</direccion>\n        <codigoPuntoVenta>0</codigoPuntoVenta>\n        <mes>1</mes>\n        <gestion>2022</gestion>\n        <ciudad>La Paz</ciudad>\n        <zona xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:nil=\"true\"></zona>\n        <numeroMedidor>23828382938</numeroMedidor>\n        <fechaEmision>2022-04-13T15:54:34.315</fechaEmision>\n        <nombreRazonSocial>go>\n        <numeroTarjeta xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:nil=\"true\"></numeroTarjeta>\n        <montoTotal>770.0</montoTotal>\n        <montoTotalSujetoIva>720.0</montoTotalSujetoIva>\n        <consumoPeriodo>123123.0</consumoPeriodo>\n        <beneficiarioLey1886>2323123123</beneficiarioLey1886>\n        <montoDescuentoLey1886>10.0</montoDescuentoLey1886>\n        <montoDescuentoTarifaDignidad>10.0</montoDescuentoTarifaDignidad>\n        <tasaAseo>10.0</tasaAseo>\n        <tasaAlumbrado>10.0</tasaAlumbrado>\n        <ajusteNoSujetoIva>10.0</ajusteNoSujetoIva>\n        <detalleAjusteNoSujetoIva>{\"danil1\":10.0}</detalleAjusteNoSujetoIva>\n        <ajusteSujetoIva>20.0</ajusteSujetoIva>\n        <detalleAjusteSujetoIva>{\"danil1\":10.0,\"danil2\":10.0}</detalleAjusteSujetoIva>\n        <otrosPagosNoSujetoIva>20.0</otrosPagosNoSujetoIva>\n        <detalleOtrosPagosNoSujetoIva>{\"danil1\":10.0,\"danil2\":10.0}</detalleOtrosPagosNoSujetoIva>\n        <otrasTasas>10.0</otrasTasas>\n        <codigoMoneda>1</codigoMoneda>\n        <tipoCambio>1</tipoCambio>\n        <montoTotalMoneda>770.0</montoTotalMoneda>\n        <descuentoAdicional>0.0</descuentoAdicional>\n        <cokjzMPdUgQZhPwVfPcz7x\naCy0HpPlv14Nfr+EBWg2/Rute9HubKkqL6YHh87O0/S14VvVjrbV9byG9odsKZp6w7itu+t17Mvw\n3/06r+yWac4PJKWnNWZFFZ0IigGrI37Xc6QLkO+zoqPaJPwr746Xe66vrF6eTttG6xYCgFfaNhh6\n0G/jucZbGNwuNSska8TU4QZhfQQncnr2Rl0KHi1HLp1h/b+/l27sSsGk8Dxlo2K3IZLVI30Q3h7h\nBzRbx5tSmUWIjpqWOy89Br8pVB2lC3xGtyE5aVd6IQ==\n</X509Certificate>\n</X509Data>\n</KeyInfo>\n</Signature></facturaElectronicaServicioBasico>",
    "detailInvoice": [
      {
        "detailId": 831,
        "activityEconomic": "620100",
        "codeProductSin": "83141",
        "codeProduct": "AWS PACK 1",
        "description": "PRODUCTO DE PRUEBA 1",
        "qty": 1.0,
        "unitMeasure": 62,
        "priceUnit": 700.0,
        "amountDiscount": 0.0,
        "subTotal": 700.0,
        "numberSerial": null,
        "numberImei": null
      }
    ]
  }
}

Anulación de la Factura

Se permite hacer la anulación de la factura en su modalidad correspondiente.

Modalidad Electrónica en Línea

POST https://sandbox.cucu.bo/api/v1/invoice/electronic/basicService/anulation

Modalidad Computarizada en Línea

POST https://sandbox.cucu.bo/api/v1/invoice/computarized/basicService/anulation
ParámetroTipoRequeridoDescripciónPetición
posIdIntSiId asignado.Req / Res
branchIdIntNoId sucursal.
invoiceCodeStringSiCódigo de factura que está siendo anulado.Req / Res
codeMotiveIntSiAutogenerado desde catálogos por el agrupador 7. (Indica el motivo por el cual la Factura está siendo anulada).Req / Res
invoiceNumberIntSiNúmero de factura que está siendo anulado.Req / Res
siatCodeStateIntCódigo de estado enviado por el SIN.Res
siatDescriptionStatusStringDescripción del estado enviado por el SIN.Res
qrCodeStringCódigo Qr que redirecciona a la pagina de SIAT y su respectiva factura.Res

Request

{
  "invoiceCode": "8D0A3ACD",
  "posId": 1,
  "codeMotive": 1,
  "invoiceNumber": 425
}

Response

{
  "message": "COMPLETED_SERVICE_BASIC",
  "errors": null,
  "success": true,
  "data": {
    "invoiceNumber": 425,
    "cuf": "1D2C888524A59EF44D23993EF83974195FC1A72FFA50D6A945FCB56D74",
    "siatCodeState": 905,
    "siatDescriptionStatus": "ANULACION CONFIRMADA",
    "qrCode": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=6822046012&cuf=1D2C888524A59EF44D23993EF83974195FC1A72FFA50D6A945FCB56D74&numero=425&t=2",
    "invoiceCode": "8D0A3ACD"
  }
}