Ir al contenido

Factura (01)

La factura electrónica (type: "01", esquema MH versión 2) documenta ventas a consumidores finales. Desde el 1 de enero de 2025 reemplaza a los tiquetes. Si el comprador es contribuyente y necesita deducir el IVA, emite un crédito fiscal.

  • Precios con IVA incluido. unit_price es el precio final que paga el cliente. sudte calcula el IVA contenido como gravada ÷ 1.13 × 0.13 para el resumen.
  • Receptor opcional por debajo de $25,000. Por aviso de la DGII (5 de septiembre de 2024), no se debe exigir documento de identificación ni correo al consumidor final en esas ventas. Si los tienes, envíalos para que sudte le mande el documento.
  • Ventas de $25,000 o más requieren identificar al receptor (document_type y document_number).
  • Puedes combinar ítems gravada, exenta y no_sujeta en el mismo documento.
POST /v1/documents
{
"emitter_id": "emi_01J9Z8K2QF4T6W3X5Y7A9B1C2D",
"type": "01",
"establishment": "M001",
"point_of_sale": "P001",
"external_id": "pos-ticket-000123",
"items": [
{ "description": "Café molido 1 lb", "quantity": "2", "unit_price": "8.50", "tax": "gravada", "unit_code": "36" },
{ "description": "Bolsa reutilizable", "quantity": "1", "unit_price": "1.00", "tax": "exenta" }
],
"payment": { "condition": "1", "methods": [{ "code": "02", "amount": "18.00", "reference": "POS 4411" }] }
}
201 Created (extracto)
{
"type": "01",
"status": "processed",
"control_number": "DTE-01-M001P001-000000000000124",
"reception_stamp": "2026B71C0E9F4A2D8B6C3E1F5A7D9C2B4E6F8A1D",
"totals": {
"subtotal": "18.00",
"iva": "1.96",
"total": "18.00",
"total_in_words": "DIECIOCHO 00/100 DÓLARES"
}
}

En la factura el iva es informativo: ya está contenido en el precio. Con $17.00 gravados, el IVA es 17.00 ÷ 1.13 × 0.13 = $1.96; la venta exenta de $1.00 no lleva IVA.

{
"emitter_id": "emi_01J9Z8K2QF4T6W3X5Y7A9B1C2D",
"type": "01",
"establishment": "M001",
"point_of_sale": "P001",
"receiver": {
"name": "Ana López",
"document_type": "13",
"document_number": "012345678",
"email": "ana@example.com",
"phone": "70001234",
"address": { "department": "06", "municipality": "23", "district": "14", "line": "Colonia Escalón, pasaje 3" }
},
"items": [
{ "description": "Consulta médica general", "quantity": "1", "unit_price": "45.00", "tax": "gravada", "type": "2" }
],
"payment": { "condition": "1", "methods": [{ "code": "01", "amount": "45.00" }] }
}

El DUI va sin guion (9 dígitos). Con correo, sudte envía al receptor el JSON firmado y el PDF en cuanto el MH otorga el sello.

  • Por ítem: discount con el monto de descuento del ítem.
  • Global: global_discount con montos por tipo de venta (gravada, exenta, no_sujeta).

sudte aplica cada descuento una sola vez y recalcula el IVA sobre el valor ya descontado.