DocumentoElectronico
The root object for all electronic invoice documents.Root container for the electronic invoice document
Show properties
Show properties
Document header containing all invoice metadata and totals
Array of line items in the invoice
Additional custom fields for extra invoice information
Tax retention details (optional)
Transportation/trip details (optional)
Dispatch guide information (optional)
Transportation details (optional)
Indicates if this is a batch document (typically
true)Indicates if this is a minimal document format
Encabezado
The header section contains identification, parties, and totals.Main header object for invoice
Show properties
Show properties
Document identification and metadata
Buyer/customer information
Invoice totals in primary currency (BSD)
Invoice totals in alternate currency (USD)
Seller/vendor information (optional)
Withholding subject information (optional)
Third party information (optional)
Withholding totals (optional)
Purchase order information (optional)
IdentificacionDocumento
Document identification fields within the Encabezado.Show properties
Show properties
Document type code. Example:
"01" for invoiceInvoice number (correlative). Generated from Excel “Correlativo” column
Emission date in
DD/MM/YYYY format. Parsed from Excel “Fecha Emision” columnDue date in
DD/MM/YYYY format. Parsed from Excel “Fecha Vencimiento” columnEmission time. Default:
"10:00:00 am"Indicates if the document is annulled. Default:
falsePayment type. Default:
"Inmediato" (Immediate)Invoice series identifier
Branch office code. Default:
"002"Sale type. Default:
"Interna" (Domestic)Primary currency code. Default:
"BSD" (Bolivian Boliviano)Transaction identifier. Format:
"FA{NumeroDocumento}". Example: "FA6746"Provider type (optional)
Transaction type (optional)
Import form number (optional)
Import file number (optional)
Affected invoice series (for credit/debit notes)
Affected invoice number (for credit/debit notes)
Affected invoice date (for credit/debit notes)
Affected invoice amount (for credit/debit notes)
Comments about affected invoice (for credit/debit notes)
Special tax regime (optional)
URL to PDF version of invoice (optional)
Comprador
Buyer/customer information within the Encabezado.Show properties
Show properties
Identification document type. Example:
"V" for Venezuelan ID. Parsed from Excel “Documento” columnIdentification number. Parsed from Excel “DNI/C.I./C.C./IFE” column
Customer legal name. Parsed from Excel “Cliente” column
Customer address. Parsed from Excel “Dirección” column
Country code (ISO 3166-1 alpha-2). Example:
"VE" for VenezuelaArray of phone numbers. Parsed from Excel “Telefono” columnExample:
["4245665757"]Array of email addresses. Parsed from Excel “Correo” columnExample:
["[email protected]"]Geographic location code (optional)
Notification preference (optional)
Additional shipping information (optional)
Totales
Invoice totals in the primary currency (BSD - Bolivian Boliviano).Show properties
Show properties
Number of line items. Example:
"1"Total taxed amount (including VAT). Calculated from Excel “bolivares” column (rounded to 2 decimals)
Total exempt amount. Default:
"0.00"Total perceived amount. Default:
"0.00"Subtotal before discounts. Calculated from Excel “bolivares sin iva” column
Subtotal after discounts (same as SubtotalAntesDescuento when no discounts)
Total VAT amount. Calculated as:
MontoGravadoTotal - SubtotalAntesDescuentoTotal amount with VAT. Same as MontoGravadoTotal
Total amount to pay. Same as MontoGravadoTotal
Amount in words (Spanish). Generated using num2words libraryExample:
"cuatro mil cuatrocientos noventa y cuatro punto cuatro nueve"Array of tax subtotals
Array of payment methods
Total discounts (optional)
Total surcharges (optional)
List of surcharges (optional)
List of discounts/bonuses (optional)
Total IGTF tax (optional)
Total IGTF in VES currency (optional)
ImpuestosSubtotal
Tax breakdown within the Totales object.Array containing tax calculations. Each element has:
Example
[
{
"CodigoTotalImp": "G",
"AlicuotaImp": "16.00",
"BaseImponibleImp": "3874.56",
"ValorTotalImp": "619.93"
}
]
FormasPago
Payment methods within the Totales object.Array containing payment method details. Each element has:
Show items
Show items
Payment method description. Parsed from Excel “Forma de Pago” columnExample:
"Punto de Venta BRMN"Payment date in
DD/MM/YYYY format. Parsed from Excel “Fecha Pago” columnPayment form code. Example:
"01"Payment amount in primary currency
Payment currency. Example:
"BSD"Exchange rate. Default:
"0.00" for primary currencyExample
[
{
"Descripcion": "Punto de Venta BRMN",
"Fecha": "05/09/2025",
"Forma": "01",
"Monto": "4494.49",
"Moneda": "BSD",
"TipoCambio": "0.00"
}
]
TotalesOtraMoneda
Invoice totals in alternate currency (USD).Multi-currency totals for invoices with alternate currency display
Show properties
Show properties
Alternate currency code. Example:
"USD"Exchange rate from alternate currency to primary currency. Parsed from Excel “Tasa” columnExample:
"154.9825"Subtotal before VAT in alternate currency. Calculated from Excel “precio sin iva” column
Total perceived amount in alternate currency. Default:
"0.00"Total exempt amount in alternate currency. Default:
"0.00"Subtotal after discounts in alternate currency
Total to pay in alternate currency. Calculated from Excel “Total” column (rounded to 0 decimals)
Total VAT in alternate currency. Calculated as:
TotalAPagar - SubtotalTotal with VAT in alternate currency. Same as TotalAPagar
Amount in words in alternate currency (Spanish)Example:
"veintinueve" for 29 USDSubtotal before discounts in alternate currency
Array of tax subtotals in alternate currency (same structure as primary currency)
Total discounts in alternate currency (optional)
Total surcharges in alternate currency (optional)
List of surcharges in alternate currency (optional)
List of discounts/bonuses in alternate currency (optional)
Example
{
"Moneda": "USD",
"TipoCambio": "154.9825",
"MontoGravadoTotal": "25.0",
"MontoPercibidoTotal": "0.00",
"MontoExentoTotal": "0.00",
"Subtotal": "25.0",
"TotalAPagar": "29.0",
"TotalIVA": "4.0",
"MontoTotalConIVA": "29.0",
"MontoEnLetras": "veintinueve",
"SubtotalAntesDescuento": "25.0",
"TotalDescuento": null,
"TotalRecargos": null,
"ImpuestosSubtotal": [
{
"CodigoTotalImp": "G",
"AlicuotaImp": "16.00",
"BaseImponibleImp": "25.0",
"ValorTotalImp": "4.0"
}
]
}
DetallesItems
Array of invoice line items.Each element represents a line item in the invoice
Show items
Show items
Line item number. Example:
"1"Product lookup code. Example:
"005"Indicator for goods or services.
"2" = ServiceItem description. Parsed from Excel “Plan” columnExample:
"PLAN OPTIMO 300 MBPS"Quantity. Example:
"1"Unit of measure code. Example:
"4L"Unit price (before VAT). Calculated from “bolivares sin iva” column
Item price (before VAT)
Price before discounts
Discount amount. Default:
"0.00"Surcharge amount. Default:
"0"Tax code. Example:
"G" for general VATVAT rate. Example:
"16" for 16%VAT amount for this item
Total item value (before VAT)
Additional item information (typically empty array)
CIIU economic activity code (optional)
Unit price after discount (optional)
Bonus amount (optional)
Bonus description (optional)
Additional item tax information (optional)
Example
[
{
"NumeroLinea": "1",
"CodigoCIIU": null,
"CodigoPLU": "005",
"IndicadorBienoServicio": "2",
"Descripcion": "PLAN OPTIMO 300 MBPS",
"Cantidad": "1",
"UnidadMedida": "4L",
"PrecioUnitario": "3874.56",
"PrecioUnitarioDescuento": null,
"MontoBonificacion": null,
"DescripcionBonificacion": null,
"DescuentoMonto": "0.00",
"RecargoMonto": "0",
"PrecioItem": "3874.56",
"PrecioAntesDescuento": "3874.56",
"CodigoImpuesto": "G",
"TasaIVA": "16",
"ValorIVA": "619.93",
"ValorTotalItem": "3874.56",
"InfoAdicionalItem": [],
"ListaItemOTI": null
}
]
InfoAdicional
Additional custom information fields.The system automatically generates monthly consumption data with randomly generated navigation values (1000-6000 range) for months 1-5, along with a calculated average.
Example
[
{
"Campo": "Contrato",
"Valor": "2802"
},
{
"Campo": "Mes1",
"Valor": "JUL"
},
{
"Campo": "Mes2",
"Valor": "AGO"
},
{
"Campo": "Mes3",
"Valor": "SEP"
},
{
"Campo": "Mes4",
"Valor": "OCT"
},
{
"Campo": "Mes5",
"Valor": "NOV"
},
{
"Campo": "Mes6",
"Valor": "DIC"
},
{
"Campo": "Cmes1",
"Valor": "1399"
},
{
"Campo": "Cmes2",
"Valor": "1343"
},
{
"Campo": "Cmes3",
"Valor": "0"
},
{
"Campo": "Cmes4",
"Valor": "0"
},
{
"Campo": "Cmes5",
"Valor": "0"
},
{
"Campo": "Cmes6",
"Valor": "0"
},
{
"Campo": "Promedio",
"Valor": "1371"
}
]
The “Contrato” field is parsed from the Excel “ID Servicio” column. Monthly consumption values (Cmes1-Cmes5) are randomly generated between 1000-6000, and the “Promedio” is calculated as their average.