Ejemplos de documentos

Esta página contiene ejemplos completos de cada tipo de documento que emite Zentto Imprenta Digital. Para cada caso se muestra: (a) el JSON de la solicitud en el formato canónico de Zentto, (b) los campos clave explicados, y (c) una representación gráfica de muestra del documento emitido, con marca Zentto.

Datos de muestra

Los importes, alícuotas, IGTF, descuentos y retenciones de estos ejemplos reflejan casos reales de emisión. El emisor es ZENTTO GLOBAL TECHNOLOGY, C.A. — RIF J-50849797-0.

Estructura del cuerpo de emisión

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

---

1. Factura (01) — alícuota General (16 %) + Exento (E)

Dos ítems: el primero gravado al 16 %, el segundo exento. 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": "PRODUCTO O SERVICIO A FACTURAR 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": "PRODUCTO O SERVICIO A FACTURAR 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": "Tarjeta de débito", "amount": 316.00,
        "currency": "BSD", "exchangeRate": 0.0 }
    ]
  }
}

Campos clave: taxCode: "G" (16 %) y taxCode: "E" (exento, base no gravada). taxSubtotals agrupa la base imponible por alícuota. payments[].method: "05" = tarjeta de débito.

---

2. Factura (01) — con IGTF (3 %) por pago en divisa

Pago mixto: USD 1,00 en efectivo divisa (activa IGTF) + Bs. 89,87 en pago móvil. El IGTF se calcula 3 % sobre la base en bolívares del pago en divisa (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": "PRODUCTO O SERVICIO A FACTURAR 1", "quantity": 1,
      "unitPrice": 200.00, "netPrice": 200.00, "taxCode": "G", "taxRate": 16, "taxAmount": 32.00, "lineTotal": 232.00 },
    { "lineNumber": 2, "description": "PRODUCTO O SERVICIO A FACTURAR 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": "Efectivo Divisa", "amount": 1.00, "currency": "USD", "exchangeRate": 352.7063 },
      { "method": "02", "description": "Pago Movil",       "amount": 89.87, "currency": "BSD", "exchangeRate": 0.0 }
    ]
  }
}

Campos clave: el subtotal IGTF (3 %) se declara aparte y se suma al totalToPay (432,00 + 10,58 = 442,58). payments[].method: "09" = efectivo en divisa (gatilla IGTF).

---

3. Factura (01) — descuento por ítem

Un ítem con precio antes de descuento Bs. 200,00 y descuento Bs. 100,00 → base gravada 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": "PRODUCTO O SERVICIO A FACTURAR 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": "Tarjeta de débito", "amount": 116.00, "currency": "BSD" } ]
  }
}

Campos clave: priceBeforeDiscount y discount a nivel de ítem; el IVA se calcula sobre el netPrice (precio ya descontado).

---

4. Factura (01) — descuento global

Descuento global del 20 % aplicado al subtotal del documento (caso de descuento sobre el total, no por ítem). El descuento global se declara en totals.totalDiscount y reduce la base imponible antes del IVA.

{
  "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": "PRODUCTO O SERVICIO A FACTURAR 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": "Tarjeta de débito", "amount": 185.60, "currency": "BSD" } ]
  }
}

Campos clave: totals.totalDiscount aplica un descuento global del 20 % sobre subtotalBeforeDiscount; el IVA (16 %) se calcula sobre la base ya descontada.

---

5. Nota de Crédito (02) — referencia al documento afectado

Anula/devuelve la factura 50370 (devolución). Lleva la referencia al documento afectado en reference.

{
  "documentType": "02",
  "documentNumber": "50037",
  "currency": "BSD",
  "issueDate": "23/01/2026",
  "reference": {
    "affectedSerie": "", "affectedNumber": "50370",
    "affectedDate": "23/01/2026", "affectedAmount": 316.00, "comment": "devolucion"
  },
  "buyer": { "idType": "J", "idNumber": "59858589-9", "name": "PRUEBA DE EMPRESA", "address": "CARACAS", "country": "VE" },
  "items": [
    { "lineNumber": 1, "description": "PRODUCTO O SERVICIO A FACTURAR 1", "quantity": 1,
      "unitPrice": 100.00, "netPrice": 100.00, "taxCode": "G", "taxRate": 16, "taxAmount": 16.00, "lineTotal": 116.00 },
    { "lineNumber": 2, "description": "PRODUCTO O SERVICIO A FACTURAR 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": "Tarjeta de débito", "amount": 316.00, "currency": "BSD" } ]
  }
}

Campos clave: reference.affectedNumber, affectedDate, affectedAmount y comment (motivo) identifican la factura afectada.

---

6. Nota de Débito (03) — referencia al documento afectado

Incrementa el monto de la factura 50371. Incluye IGTF (caso real del pago en divisa).

{
  "documentType": "03",
  "documentNumber": "50007",
  "currency": "BSD",
  "issueDate": "23/01/2026",
  "reference": {
    "affectedSerie": "", "affectedNumber": "50371",
    "affectedDate": "23/01/2026", "affectedAmount": 442.58, "comment": "incremento"
  },
  "buyer": { "idType": "J", "idNumber": "59858589-9", "name": "PRUEBA DE EMPRESA", "address": "CARACAS", "country": "VE" },
  "items": [
    { "lineNumber": 1, "description": "PRODUCTO O SERVICIO A FACTURAR 1", "quantity": 1,
      "unitPrice": 200.00, "netPrice": 200.00, "taxCode": "G", "taxRate": 16, "taxAmount": 32.00, "lineTotal": 232.00 },
    { "lineNumber": 2, "description": "PRODUCTO O SERVICIO A FACTURAR 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": "Efectivo Divisa", "amount": 1.00, "currency": "USD", "exchangeRate": 352.7063 },
      { "method": "02", "description": "Pago Movil",       "amount": 89.87, "currency": "BSD" }
    ]
  }
}

---

7. Comprobante de Retención de IVA (05)

Comprobante de retención de IVA al sujeto retenido. El sujeto se identifica en withheldSubject; los detalles de retención van en withholdingDetails.

{
  "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 }
}

Campos clave: withheldSubject (sujeto retenido), withholdingTotals.voucherType (tipo de comprobante).

---

8. Comprobante de Retención de ISLR (06) — validación

Retención de ISLR con base imponible Bs. 10.000,00, porcentaje 3 % y sustraendo 1,00 → retenido Bs. 299,00 (concepto 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"
    }
  ]
}

Campos clave: withholdingDetails[].withholdingRate (0,03), subtrahend (sustraendo), concept (código de concepto ISLR) y controlNumber del documento retenido.

---

9. Comprobantes en negativo (correctivos)

Para corregir un comprobante de retención previamente emitido, se emite un comprobante en negativo con los mismos campos y montos con signo invertido. Aplica tanto a la retención de IVA (05) como a la retención de ISLR (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" }
  ]
}

Campos clave: todos los montos (taxableBase, withheld, totalBase, totalIslr) van en negativo para revertir el comprobante original.

---

---

Payloads del documento electrónico (estructura nativa)

Los siguientes ejemplos corresponden a los datos de prueba del estándar fiscal, en la estructura nativa del documento electrónico (DocumentoElectronico / Encabezado / IdentificacionDocumento …, en PascalCase). El emisor es ZENTTO GLOBAL TECHNOLOGY, C.A. — RIF J-50849797-0. Úsalos contra el ambiente demo con las credenciales de prueba.

Factura básica (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)."
      }
    ]
  }
}

Nota de crédito / nota de débito (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"
      }
    ]
  }
}

---

Representación gráfica (muestra Zentto)

Descarga los PDFs de representación gráfica de muestra —tal como se imprime el documento emitido—, con marca Zentto (emisor ZENTTO GLOBAL TECHNOLOGY, C.A. — RIF J-508497970) e importes de estos ejemplos:

Documento de ejemplo	Descarga
Factura (G 16 % + Exento + IGTF)	PDF
Nota de Crédito (ref. factura D-50370)	PDF
Nota de Débito (ref. factura D-50371)	PDF

Estos ejemplos se generan con el script reproducible scripts/gen-ejemplos-documentos.cjs.

Las mismas representaciones de muestra se incluyen en los manuales descargables:

• Manual de Usuario e Integración (ES)
• User & Integration Manual (EN)

El layout de la representación gráfica incluye: encabezado con logo Zentto y recuadro del documento (N° Documento, N° Control, Fecha y Hora de emisión), bloques Emisor y Receptor, tabla de ítems (Descripción · Cantidad · Código · Valor Unitario · Valor Total Ítem · Tipo Impuesto · Valor Impuesto), tabla de Formas de Pago, Información Adicional, el recuadro de Totales (Base Imponible por alícuota, Exento, Subtotal, IGTF, Total a Pagar) y el pie legal con la providencia y los datos de la imprenta autorizada.