Invoice Structure

Overview

The electronic invoice system uses a structured JSON format called DocumentoElectronico (Electronic Document). This schema encompasses all necessary data for Venezuelan tax-compliant invoicing, including buyer/seller information, line items, totals, and multi-currency support.

Root Structure

Every invoice JSON file contains a single root object:

{
  "DocumentoElectronico": {
    "Encabezado": { ... },
    "DetallesItems": [ ... ],
    "InfoAdicional": [ ... ],
    "EsLote": true,
    "EsMinimo": null
  }
}

DocumentoElectronico

object

required

Root container for all invoice data

Show properties

Encabezado

object

required

Header section containing identification, parties, and totals

DetallesItems

array

required

Line items array - products or services being invoiced

InfoAdicional

array

Additional metadata fields for custom business data

EsLote

boolean

Indicates if this invoice is part of a batch submission (always true in this system)

EsMinimo

boolean | null

Reserved for minimum invoice indicator

Encabezado (Header Section)

The header contains five main subsections: document identification, buyer information, seller information (optional), totals in primary currency (BSD), and totals in secondary currency (USD).

IdentificacionDocumento

object

required

Document identification and metadata

Show properties

TipoDocumento

string

required

Document type code. "01" indicates a standard invoice (factura)

NumeroDocumento

string

required

Sequential invoice number (correlativo). Example: "6746"

FechaEmision

string

required

Emission date in format DD/MM/YYYY. Example: "09/09/2025"

FechaVencimiento

string

required

Due date in format DD/MM/YYYY. Example: "09/09/2025"

HoraEmision

string

required

Emission time. Example: "10:00:00 am"

Anulado

boolean

required

Indicates if invoice is cancelled. Always false for new invoices

TipoDePago

string

required

Payment type. Example: "Inmediato" (immediate)

Serie

string

Document series identifier (empty string if not used)

Sucursal

string

Branch office code. Example: "002"

TipoDeVenta

string

Sale type. Example: "Interna" (domestic)

Moneda

string

required

Primary currency code. "BSD" for Venezuelan Bolívares

TransaccionId

string

required

Unique transaction identifier. Format: "FA{NumeroDocumento}"

TipoProveedor

string | null

Provider type code (optional)

TipoTransaccion

string | null

Transaction type code (optional)

NumeroPlanillaImportacion

string | null

Import form number (used for international transactions)

NumeroExpedienteImportacion

string | null

Import file number (used for international transactions)

SerieFacturaAfectada

string | null

Series of affected invoice (for credit notes)

NumeroFacturaAfectada

string | null

Number of affected invoice (for credit notes)

FechaFacturaAfectada

string | null

Date of affected invoice (for credit notes)

MontoFacturaAfectada

string | null

Amount of affected invoice (for credit notes)

ComentarioFacturaAfectada

string | null

Comment about affected invoice (for credit notes)

RegimenEspTributacion

string | null

Special tax regime indicator (optional)

UrlPdf

string | null

URL to PDF version of invoice (optional)

Comprador (Buyer Information)

Comprador

object

required

Customer/buyer information

Show properties

TipoIdentificacion

string

required

Identification type. Examples: "V" (Venezuelan citizen), "E" (foreign), "J" (legal entity)

NumeroIdentificacion

string

required

Identification number (DNI/C.I./RIF). Example: "14965208"

Legal name or full name. Example: "CARLOS ALBERTO SOLANO"

Direccion

string

required

Complete address. Example: "ALI PRIMERA TORRE 15F APTO 1-2 BARQUISIMETO EDO. LARA"

Pais

string

required

Country code (ISO 3166-1 alpha-2). Example: "VE" for Venezuela

Telefono

array

required

Array of phone numbers as strings. Example: ["4245665757"]

Correo

array

required

Array of email addresses. Example: ["[email protected]"]

Ubigeo

string | null

Geographic location code (optional)

Notificar

string | null

Notification preferences (optional)

OtrosEnvios

array | null

Additional shipping addresses (optional)

Totales (Primary Currency Totals)

Totales

object

required

Totals in primary currency (BSD - Bolívares)

Show properties

NroItems

string

required

Number of line items. Example: "1"

SubtotalAntesDescuento

string

required

Subtotal before discounts. Example: "3874.56"

Subtotal

string

required

Subtotal after discounts (before tax). Example: "3874.56"

MontoGravadoTotal

string

required

Total taxable amount. Example: "4494.49"

MontoExentoTotal

string

required

Total tax-exempt amount. Example: "0.00"

TotalIVA

string

required

Total IVA (VAT) amount. Example: "619.93"

MontoTotalConIVA

string

required

Total amount including IVA. Example: "4494.49"

TotalAPagar

string

required

Final total to pay. Example: "4494.49"

MontoEnLetras

string

required

Amount in words (Spanish). Example: "cuatro mil cuatrocientos noventa y cuatro punto cuatro nueve"

ImpuestosSubtotal

array

required

Tax breakdown array

Show item properties

CodigoTotalImp

string

Tax code. "G" indicates taxable (gravado)

AlicuotaImp

string

Tax rate percentage. Example: "16.00" (16% IVA)

BaseImponibleImp

string

Tax base amount. Example: "3874.56"

ValorTotalImp

string

Total tax amount. Example: "619.93"

FormasPago

array

required

Payment methods array

Show item properties

Descripcion

string

Payment description. Example: "Punto de Venta BRMN"

Fecha

string

Payment date in format DD/MM/YYYY

Forma

string

Payment method code. Example: "01"

Monto

string

Payment amount. Example: "4494.49"

Moneda

string

Payment currency. Example: "BSD"

TipoCambio

string

Exchange rate applied. Example: "0.00"

MontoPercibidoTotal

string

Total amount received (for withholdings)

TotalDescuento

string | null

Total discounts applied

TotalRecargos

string | null

Total surcharges applied

ListaRecargo

array | null

List of surcharges (optional)

ListaDescBonificacion

array | null

List of discounts and bonuses (optional)

TotalIGTF

string | null

IGTF tax total (tax on foreign currency transactions)

TotalIGTF_VES

string | null

IGTF tax in Venezuelan currency

TotalesOtraMoneda (Secondary Currency Totals)

TotalesOtraMoneda

object

Totals in secondary currency (USD - US Dollars)

Show properties

Moneda

string

required

Currency code. Example: "USD"

TipoCambio

string

required

Exchange rate used for conversion. Example: "154.9825"

MontoGravadoTotal

string

required

Total taxable amount in USD. Example: "25.0"

Subtotal

string

required

Subtotal in USD (before tax). Example: "25.0"

TotalIVA

string

required

IVA amount in USD. Example: "4.0"

TotalAPagar

string

required

Total to pay in USD. Example: "29.0"

MontoTotalConIVA

string

required

Total including IVA in USD. Example: "29.0"

MontoEnLetras

string

required

Amount in words (Spanish). Example: "veintinueve"

SubtotalAntesDescuento

string

Subtotal before discounts in USD

ImpuestosSubtotal

array

Tax breakdown in USD (same structure as primary currency)

MontoPercibidoTotal

string

Total amount received in USD

MontoExentoTotal

string

Total tax-exempt amount in USD

TotalDescuento

string | null

Total discounts in USD

TotalRecargos

string | null

Total surcharges in USD

ListaRecargo

array | null

List of surcharges in USD

ListaDescBonificacion

array | null

List of discounts in USD

DetallesItems (Line Items)

The DetallesItems array contains one or more line items representing the products or services being invoiced.

DetallesItems

array

required

Array of invoice line items

Show item properties

NumeroLinea

string

required

Line number (sequential). Example: "1"

Descripcion

string

required

Product or service description. Example: "PLAN OPTIMO 300 MBPS"

Cantidad

string

required

Quantity. Example: "1"

UnidadMedida

string

required

Unit of measure code. Example: "4L" (service unit)

PrecioUnitario

string

required

Unit price (before tax). Example: "3874.56"

PrecioItem

string

required

Item subtotal (quantity × unit price). Example: "3874.56"

PrecioAntesDescuento

string

required

Price before any discounts. Example: "3874.56"

CodigoImpuesto

string

required

Tax code. "G" for taxable items

TasaIVA

string

required

IVA rate percentage. Example: "16"

ValorIVA

string

required

IVA amount for this item. Example: "619.93"

ValorTotalItem

string

required

Total item value (before tax). Example: "3874.56"

CodigoPLU

string

Product lookup code. Example: "005"

IndicadorBienoServicio

string

Good or service indicator. "2" for services, "1" for goods

DescuentoMonto

string

Discount amount. Example: "0.00"

RecargoMonto

string

Surcharge amount. Example: "0"

InfoAdicionalItem

array

Additional item-level information (optional)

CodigoCIIU

string | null

Industrial classification code (optional)

PrecioUnitarioDescuento

string | null

Unit price after discount (optional)

MontoBonificacion

string | null

Bonus amount (optional)

DescripcionBonificacion

string | null

Bonus description (optional)

ListaItemOTI

array | null

Other taxes on items (optional)

Example Line Item

{
  "NumeroLinea": "1",
  "CodigoPLU": "005",
  "IndicadorBienoServicio": "2",
  "Descripcion": "PLAN OPTIMO 300 MBPS",
  "Cantidad": "1",
  "UnidadMedida": "4L",
  "PrecioUnitario": "3874.56",
  "PrecioItem": "3874.56",
  "CodigoImpuesto": "G",
  "TasaIVA": "16",
  "ValorIVA": "619.93",
  "ValorTotalItem": "3874.56"
}

InfoAdicional (Additional Information)

The InfoAdicional array contains custom key-value pairs for business-specific metadata. In this system, it’s used to track service contracts and usage data.

InfoAdicional

array

Array of additional metadata fields

Show item properties

Campo

string

required

Field name/key. Examples: "Contrato", "Mes1", "Cmes1", "Promedio"

Valor

string

required

Field value. Examples: "2802", "JUL", "1399", "1371"

Standard Fields Used

{
  "Campo": "Contrato",
  "Valor": "2802"
}

The system tracks:

Contrato: Service contract ID
Mes1-Mes6: Month names (Spanish abbreviations)
Cmes1-Cmes6: Consumption/usage data per month (in MB or similar units)
Promedio: Average usage across all months

Complete Example

Here’s a complete invoice structure from the system:

View Complete Invoice JSON

{
  "DocumentoElectronico": {
    "Encabezado": {
      "IdentificacionDocumento": {
        "TipoDocumento": "01",
        "NumeroDocumento": "6746",
        "FechaEmision": "09/09/2025",
        "FechaVencimiento": "09/09/2025",
        "HoraEmision": "10:00:00 am",
        "Anulado": false,
        "TipoDePago": "Inmediato",
        "Moneda": "BSD",
        "TransaccionId": "FA6746"
      },
      "Comprador": {
        "TipoIdentificacion": "V",
        "NumeroIdentificacion": "14965208",
        "RazonSocial": "CARLOS ALBERTO SOLANO",
        "Direccion": "ALI PRIMERA TORRE 15F APTO 1-2 BARQUISIMETO EDO. LARA",
        "Pais": "VE",
        "Telefono": ["4245665757"],
        "Correo": ["[email protected]"]
      },
      "Totales": {
        "NroItems": "1",
        "MontoGravadoTotal": "4494.49",
        "Subtotal": "3874.56",
        "TotalIVA": "619.93",
        "TotalAPagar": "4494.49",
        "MontoEnLetras": "cuatro mil cuatrocientos noventa y cuatro punto cuatro nueve"
      },
      "TotalesOtraMoneda": {
        "Moneda": "USD",
        "TipoCambio": "154.9825",
        "Subtotal": "25.0",
        "TotalIVA": "4.0",
        "TotalAPagar": "29.0"
      }
    },
    "DetallesItems": [
      {
        "NumeroLinea": "1",
        "Descripcion": "PLAN OPTIMO 300 MBPS",
        "Cantidad": "1",
        "PrecioUnitario": "3874.56",
        "TasaIVA": "16",
        "ValorIVA": "619.93"
      }
    ],
    "InfoAdicional": [
      { "Campo": "Contrato", "Valor": "2802" },
      { "Campo": "Mes1", "Valor": "JUL" },
      { "Campo": "Promedio", "Valor": "1371" }
    ],
    "EsLote": true
  }
}

Getting Started

Core Concepts

Guides

Overview

Root Structure

Encabezado (Header Section)

IdentificacionDocumento

Comprador (Buyer Information)

Totales (Primary Currency Totals)

TotalesOtraMoneda (Secondary Currency Totals)

DetallesItems (Line Items)

Example Line Item

InfoAdicional (Additional Information)

Standard Fields Used

Complete Example

Build docs developers (and LLMs) love

Getting Started

Core Concepts

Guides

​Overview

​Root Structure

​Encabezado (Header Section)

​IdentificacionDocumento

​Comprador (Buyer Information)

​Totales (Primary Currency Totals)

​TotalesOtraMoneda (Secondary Currency Totals)

​DetallesItems (Line Items)

​Example Line Item

​InfoAdicional (Additional Information)

​Standard Fields Used

​Complete Example

Build docs developers (and LLMs) love

Overview

Root Structure

Encabezado (Header Section)

IdentificacionDocumento

Comprador (Buyer Information)

Totales (Primary Currency Totals)

TotalesOtraMoneda (Secondary Currency Totals)

DetallesItems (Line Items)

Example Line Item

InfoAdicional (Additional Information)

Standard Fields Used

Complete Example