Document examples

This page contains complete examples of each document type Zentto Digital Print issues. For each case it shows: (a) the request JSON in Zentto’s canonical format, (b) the key fields explained, and (c) a sample graphical representation, Zentto-branded.

Issuance body structure

{
  "environment": "production",
  "document": {
    "documentType": "01",
    "documentNumber": "50370",
    "serie": "A",
    "currency": "BSD",
    "issueDate": "23/01/2026",
    "buyer": { "...": "..." },
    "items": [ { "...": "..." } ],
    "totals": { "...": "..." }
  }
}

1. Invoice (01) — General rate (16%) + Exempt (E)

Two items: the first taxed at 16%, the second exempt. Total Bs. 316.00.

{
  "documentType": "01", "documentNumber": "50370", "currency": "BSD", "issueDate": "23/01/2026",
  "buyer": { "idType": "J", "idNumber": "59858589-9", "name": "PRUEBA DE EMPRESA", "address": "CARACAS", "country": "VE" },
  "items": [
    { "lineNumber": 1, "description": "PRODUCT OR SERVICE 1", "quantity": 1, "unitPrice": 100.00,
      "discount": 0.00, "netPrice": 100.00, "taxCode": "G", "taxRate": 16, "taxAmount": 16.00, "lineTotal": 116.00 },
    { "lineNumber": 2, "description": "PRODUCT OR SERVICE 2", "quantity": 1, "unitPrice": 200.00,
      "discount": 0.00, "netPrice": 200.00, "taxCode": "E", "taxRate": 0, "taxAmount": 0.00, "lineTotal": 200.00 }
  ],
  "totals": {
    "itemCount": 2, "taxedAmount": 100.00, "exemptAmount": 200.00,
    "subtotal": 300.00, "totalIva": 16.00, "totalWithIva": 316.00, "totalToPay": 316.00,
    "taxSubtotals": [
      { "code": "E", "rate": 0, "base": 200.00, "amount": 0.00 },
      { "code": "G", "rate": 16, "base": 100.00, "amount": 16.00 }
    ],
    "payments": [ { "method": "05", "description": "Debit card", "amount": 316.00, "currency": "BSD" } ]
  }
}

Key fields: taxCode: "G" (16%) and taxCode: "E" (exempt). taxSubtotals groups the taxable base per rate.

2. Invoice (01) — with IGTF (3%) on a foreign-currency payment

Mixed payment: USD 1.00 cash (triggers IGTF) + Bs. 89.87 mobile payment. IGTF is 3% over the bolívar base of the FX payment (Bs. 352.70 → Bs. 10.58).

{
  "documentType": "01", "documentNumber": "50371", "currency": "BSD", "issueDate": "23/01/2026",
  "buyer": { "idType": "J", "idNumber": "59858589-9", "name": "PRUEBA DE EMPRESA", "address": "CARACAS", "country": "VE" },
  "items": [
    { "lineNumber": 1, "description": "PRODUCT OR SERVICE 1", "quantity": 1, "unitPrice": 200.00,
      "netPrice": 200.00, "taxCode": "G", "taxRate": 16, "taxAmount": 32.00, "lineTotal": 232.00 },
    { "lineNumber": 2, "description": "PRODUCT OR SERVICE 2", "quantity": 1, "unitPrice": 200.00,
      "netPrice": 200.00, "taxCode": "E", "taxRate": 0, "taxAmount": 0.00, "lineTotal": 200.00 }
  ],
  "totals": {
    "itemCount": 2, "taxedAmount": 200.00, "exemptAmount": 200.00,
    "subtotal": 400.00, "totalIva": 32.00, "totalWithIva": 432.00, "totalToPay": 442.58, "igtf": 10.58,
    "taxSubtotals": [
      { "code": "E", "rate": 0, "base": 200.00, "amount": 0.00 },
      { "code": "IGTF", "rate": 3, "base": 352.70, "amount": 10.58 },
      { "code": "G", "rate": 16, "base": 200.00, "amount": 32.00 }
    ],
    "payments": [
      { "method": "09", "description": "FX cash", "amount": 1.00, "currency": "USD", "exchangeRate": 352.7063 },
      { "method": "02", "description": "Mobile payment", "amount": 89.87, "currency": "BSD" }
    ]
  }
}

Key fields: the IGTF subtotal (3%) is declared separately and added to totalToPay (432.00 + 10.58 = 442.58). payments[].method: "09" = FX cash (triggers IGTF).

3. Invoice (01) — per-item discount

One item with price-before-discount Bs. 200.00 and a Bs. 100.00 discount → taxable base Bs. 100.00.

{
  "documentType": "01", "documentNumber": "50373", "currency": "BSD", "issueDate": "23/01/2026",
  "buyer": { "idType": "J", "idNumber": "59858589-9", "name": "PRUEBA DE EMPRESA", "address": "CARACAS", "country": "VE" },
  "items": [
    { "lineNumber": 1, "description": "PRODUCT OR SERVICE 1", "quantity": 1, "unitPrice": 200.00,
      "priceBeforeDiscount": 200.00, "discount": 100.00, "netPrice": 100.00,
      "taxCode": "G", "taxRate": 16, "taxAmount": 16.00, "lineTotal": 116.00 }
  ],
  "totals": {
    "itemCount": 1, "taxedAmount": 100.00, "subtotalBeforeDiscount": 100.00,
    "subtotal": 100.00, "totalIva": 16.00, "totalWithIva": 116.00, "totalToPay": 116.00,
    "taxSubtotals": [ { "code": "G", "rate": 16, "base": 100.00, "amount": 16.00 } ],
    "payments": [ { "method": "05", "description": "Debit card", "amount": 116.00, "currency": "BSD" } ]
  }
}

Key fields: priceBeforeDiscount and discount at line level; VAT is computed on netPrice (already discounted).

4. Invoice (01) — global discount

A 20% global discount on the document subtotal, declared in totals.totalDiscount.

{
  "documentType": "01", "documentNumber": "50374", "currency": "BSD", "issueDate": "23/01/2026",
  "buyer": { "idType": "J", "idNumber": "59858589-9", "name": "PRUEBA DE EMPRESA", "address": "CARACAS", "country": "VE" },
  "items": [
    { "lineNumber": 1, "description": "PRODUCT OR SERVICE 1", "quantity": 1, "unitPrice": 200.00,
      "netPrice": 200.00, "taxCode": "G", "taxRate": 16, "lineTotal": 232.00 }
  ],
  "totals": {
    "itemCount": 1, "subtotalBeforeDiscount": 200.00, "totalDiscount": 40.00,
    "taxedAmount": 160.00, "subtotal": 160.00, "totalIva": 25.60,
    "totalWithIva": 185.60, "totalToPay": 185.60,
    "taxSubtotals": [ { "code": "G", "rate": 16, "base": 160.00, "amount": 25.60 } ],
    "payments": [ { "method": "05", "description": "Debit card", "amount": 185.60, "currency": "BSD" } ]
  }
}

Key fields: totals.totalDiscount applies a 20% global discount on subtotalBeforeDiscount; VAT (16%) is computed on the discounted base.

5. Credit Note (02) — reference to the affected document

Returns/voids invoice 50370 (return). Carries the affected-document reference in reference.

{
  "documentType": "02", "documentNumber": "50037", "currency": "BSD", "issueDate": "23/01/2026",
  "reference": { "affectedSerie": "", "affectedNumber": "50370", "affectedDate": "23/01/2026", "affectedAmount": 316.00, "comment": "return" },
  "buyer": { "idType": "J", "idNumber": "59858589-9", "name": "PRUEBA DE EMPRESA", "address": "CARACAS", "country": "VE" },
  "items": [
    { "lineNumber": 1, "description": "PRODUCT OR SERVICE 1", "quantity": 1, "unitPrice": 100.00,
      "netPrice": 100.00, "taxCode": "G", "taxRate": 16, "taxAmount": 16.00, "lineTotal": 116.00 },
    { "lineNumber": 2, "description": "PRODUCT OR SERVICE 2", "quantity": 1, "unitPrice": 200.00,
      "netPrice": 200.00, "taxCode": "E", "taxRate": 0, "taxAmount": 0.00, "lineTotal": 200.00 }
  ],
  "totals": {
    "itemCount": 2, "taxedAmount": 100.00, "exemptAmount": 200.00,
    "subtotal": 300.00, "totalIva": 16.00, "totalWithIva": 316.00, "totalToPay": 316.00,
    "taxSubtotals": [
      { "code": "E", "rate": 0, "base": 200.00, "amount": 0.00 },
      { "code": "G", "rate": 16, "base": 100.00, "amount": 16.00 }
    ],
    "payments": [ { "method": "05", "description": "Debit card", "amount": 316.00, "currency": "BSD" } ]
  }
}

Key fields: reference.affectedNumber, affectedDate, affectedAmount and comment (reason) identify the affected invoice.

6. Debit Note (03) — reference to the affected document

Increases the amount of invoice 50371. Includes IGTF (the real FX-payment case).

{
  "documentType": "03", "documentNumber": "50007", "currency": "BSD", "issueDate": "23/01/2026",
  "reference": { "affectedSerie": "", "affectedNumber": "50371", "affectedDate": "23/01/2026", "affectedAmount": 442.58, "comment": "increase" },
  "buyer": { "idType": "J", "idNumber": "59858589-9", "name": "PRUEBA DE EMPRESA", "address": "CARACAS", "country": "VE" },
  "items": [
    { "lineNumber": 1, "description": "PRODUCT OR SERVICE 1", "quantity": 1, "unitPrice": 200.00,
      "netPrice": 200.00, "taxCode": "G", "taxRate": 16, "taxAmount": 32.00, "lineTotal": 232.00 },
    { "lineNumber": 2, "description": "PRODUCT OR SERVICE 2", "quantity": 1, "unitPrice": 200.00,
      "netPrice": 200.00, "taxCode": "E", "taxRate": 0, "taxAmount": 0.00, "lineTotal": 200.00 }
  ],
  "totals": {
    "itemCount": 2, "taxedAmount": 200.00, "exemptAmount": 200.00,
    "subtotal": 400.00, "totalIva": 32.00, "totalWithIva": 432.00, "totalToPay": 442.58, "igtf": 10.58,
    "taxSubtotals": [
      { "code": "E", "rate": 0, "base": 200.00, "amount": 0.00 },
      { "code": "IGTF", "rate": 3, "base": 352.70, "amount": 10.58 },
      { "code": "G", "rate": 16, "base": 200.00, "amount": 32.00 }
    ],
    "payments": [
      { "method": "09", "description": "FX cash", "amount": 1.00, "currency": "USD", "exchangeRate": 352.7063 },
      { "method": "02", "description": "Mobile payment", "amount": 89.87, "currency": "BSD" }
    ]
  }
}

7. VAT Withholding Voucher (05)

VAT withholding to the withheld subject, identified in withheldSubject.

{
  "documentType": "05", "documentNumber": "20260200000005", "currency": "BSD", "issueDate": "23/02/2026",
  "withheldSubject": { "idType": "J", "idNumber": "000000140", "name": "PRUEBA X5", "address": "CCS", "country": "VE", "notify": "Si" },
  "withholdingTotals": { "totalBase": 0.00, "totalWithheld": 0.00, "voucherType": "1" },
  "totals": { "itemCount": 1, "totalWithIva": 7637.60, "totalToPay": 0.00 }
}

Key fields: withheldSubject (withheld subject), withholdingTotals.voucherType.

8. ISLR Withholding Voucher (06) — validation

ISLR withholding with taxable base Bs. 10,000.00, 3% rate and subtrahend 1.00 → withheld Bs. 299.00 (concept 025).

{
  "documentType": "06", "documentNumber": "", "currency": "BSD", "issueDate": "03/06/2025", "transactionId": "28012228",
  "withheldSubject": { "idType": "V", "idNumber": "99999999", "name": "PEDRO PEREZ", "address": "PRUEBA", "country": "VE", "notify": "Si" },
  "withholdingTotals": { "totalBase": 10000.00, "voucherNumber": "28012228", "voucherDate": "03/06/2025", "totalIslr": 299.00, "voucherType": "1" },
  "withholdingDetails": [
    { "lineNumber": 1, "documentDate": "03/06/2025", "documentType": "01", "documentNumber": "20250603",
      "controlNumber": "202506063", "taxableBase": 10000.00, "withholdingRate": 0.03, "subtrahend": 1.00,
      "withheld": 299.00, "concept": "025", "currency": "BSD" }
  ]
}

Key fields: withholdingDetails[].withholdingRate (0.03), subtrahend, concept (ISLR concept code) and the controlNumber of the withheld document.

9. Negative vouchers (corrective)

To correct a previously issued withholding voucher, a negative voucher is issued with the same fields and amounts with inverted sign. Applies to both VAT withholding (05) and ISLR withholding (06).

{
  "documentType": "06", "documentNumber": "", "issueDate": "23/02/2026",
  "withheldSubject": { "idType": "J", "idNumber": "000000140", "name": "PRUEBA X5", "country": "VE" },
  "withholdingTotals": { "totalBase": -10000.00, "totalIslr": -299.00, "voucherType": "1" },
  "withholdingDetails": [
    { "lineNumber": 1, "taxableBase": -10000.00, "withholdingRate": 0.03, "subtrahend": 1.00,
      "withheld": -299.00, "concept": "025", "currency": "BSD" }
  ]
}

Key fields: all amounts (taxableBase, withheld, totalBase, totalIslr) are negative to reverse the original voucher.

Electronic document payloads (native structure)

The following examples are the fiscal-standard test data, in the document’s native structure (DocumentoElectronico / Encabezado / IdentificacionDocumento …, in PascalCase). The issuer is ZENTTO GLOBAL TECHNOLOGY, C.A. — RIF J-50849797-0. Use them against the demo environment with the test credentials.

Basic invoice (01)

{
  "documentoElectronico": {
    "encabezado": {
      "identificacionDocumento": {
        "tipoDocumento": "01",
        "numeroDocumento": "00000023-0",
        "tipoTransaccion": "01",
        "fechaEmision": "07/09/2026",
        "fechaVencimiento": "08/09/2026",
        "horaEmision": "01:36:22 pm",
        "tipoDePago": "CONTADO",
        "serie": "A",
        "tipoDeVenta": "EN LINEA",
        "moneda": "BsD"
      },
      "comprador": {
        "tipoIdentificacion": "V",
        "numeroIdentificacion": "005534237-0",
        "razonSocial": "NELSON IVAN, LINARES OROPEZA",
        "direccion": "URB EL HATILLO, EL HATILLO-1083, CARACAS, EDO. DISTRITO CAPITAL, VENEZUELA",
        "pais": "VE",
        "telefono": [
          "+58-4142369327"
        ],
        "correo": [
          "cliente@zentto.net"
        ]
      }
    },
    "detallesItems": [
      {
        "numeroLinea": "1",
        "codigoPLU": "03-2026",
        "indicadorBienoServicio": "2",
        "descripcion": "CUOTA MANTENIMIENTO",
        "cantidad": "1",
        "precioUnitario": "1400",
        "precioItem": "1400",
        "codigoImpuesto": "G",
        "tasaIVA": "16",
        "valorIVA": "224",
        "valorTotalItem": "1624"
      }
    ],
    "infoAdicional": [
      {
        "campo": "Informativo",
        "valor": "De conformidad con la normativa vigente del SENIAT, este pago esta sujeto al cobro adicional del 3% del Impuesto a las Grandes Transacciones Financieras (IGTF)."
      }
    ]
  }
}

Credit note / debit note (03)

{
  "DocumentoElectronico": {
    "Encabezado": {
      "IdentificacionDocumento": {
        "TipoDocumento": "03",
        "NumeroDocumento": "00051224",
        "TipoProveedor": "",
        "TipoTransaccion": "02",
        "SerieFacturaAfectada": "A",
        "NumeroFacturaAfectada": "10254",
        "FechaFacturaAfectada": "10/01/2026",
        "MontoFacturaAfectada": "10.00",
        "ComentarioFacturaAfectada": "prueba",
        "FechaEmision": "07/03/2026",
        "HoraEmision": "01:23:05 pm",
        "Anulado": false,
        "TipoDePago": "importado",
        "Serie": "A",
        "Sucursal": "0001",
        "TipoDeVenta": "interna",
        "Moneda": "VES"
      },
      "Vendedor": {
        "Codigo": "A01",
        "Nombre": "Moises Parra",
        "NumCajero": "001"
      },
      "Comprador": {
        "TipoIdentificacion": "V",
        "NumeroIdentificacion": "26159207-0",
        "RazonSocial": "Eduardo Montiel",
        "Direccion": "Av Principal de algun sitio",
        "Pais": "VE",
        "Telefono": [
          "+582122447664"
        ],
        "Correo": [
          "cliente@zentto.net"
        ]
      },
      "Totales": {
        "NroItems": "1",
        "MontoGravadoTotal": "10.00",
        "MontoExentoTotal": "0",
        "Subtotal": "10.00",
        "TotalAPagar": "11.60",
        "TotalIVA": "1.60",
        "MontoTotalConIVA": "11.60",
        "MontoEnLetras": "ONCE BOLIVARES CON SESENTA CENTIMOS",
        "TotalDescuento": "0",
        "ImpuestosSubtotal": [
          {
            "CodigoTotalImp": "G",
            "AlicuotaImp": "16.00",
            "BaseImponibleImp": "10.00",
            "ValorTotalImp": "1.60"
          }
        ],
        "FormasPago": [
          {
            "Forma": "01",
            "Monto": "11.60",
            "Moneda": "VES",
            "TipoCambio": ""
          }
        ]
      }
    },
    "DetallesItems": [
      {
        "NumeroLinea": "1",
        "CodigoPLU": "7591",
        "IndicadorBienoServicio": "1",
        "Descripcion": "Refresco PET 500 ml",
        "Cantidad": "2",
        "UnidadMedida": "NIU",
        "PrecioUnitario": "5.00",
        "PrecioItem": "10.00",
        "CodigoImpuesto": "G",
        "TasaIVA": "16.00",
        "ValorIVA": "1.60",
        "ValorTotalItem": "11.60"
      }
    ]
  }
}

Graphical representation (Zentto sample)

Download the sample graphical representation PDFs —as the issued document is printed—, Zentto-branded (issuer ZENTTO GLOBAL TECHNOLOGY, C.A. — RIF J-508497970) with the amounts from these examples:

Sample document	Download
Invoice (G 16% + Exempt + IGTF)	PDF
Credit Note (ref. invoice D-50370)	PDF
Debit Note (ref. invoice D-50371)	PDF

These samples are generated with the reproducible script scripts/gen-ejemplos-documentos.cjs.

The same sample representations are also included in the downloadable manuals:

The graphical layout includes: header with Zentto logo and document box (Document No., Control No., issue date and time), Issuer and Receiver blocks, the item table (Description · Quantity · Code · Unit Value · Item Total · Tax Type · Tax Value), the Payment methods table, Additional information, the Totals box (taxable base per rate, Exempt, Subtotal, IGTF, Total to Pay) and the legal footer with the regulation and the authorized-printer details.