FacturaElectrónica-JSON

📖 Introducción

¿Qué es Json-Api?

Json-Api es una API REST que permite integrar la facturación electrónica de Paraguay con tu sistema contable existente. Compatible con SIFEN y DNIT, ofrece una solución simple y rápida para emitir documentos tributarios electrónicos.

Características Principales

✅ Integración simple con API REST
✅ Compatible con SIFEN y DNIT
✅ Soporte para PHP y PostgreSQL
✅ Documentación completa
✅ Ejemplos de código reales

⚙️ Configuración Inicial

1. Endpoint de la API

URL Base de la API ENDPOINT

POST https://api.json-api.com/v1/invoice
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

2. Estructura Básica de la Petición

Estructura JSON Básica JSON

{
  "fecha": "2024-01-15",
  "punto": 1,
  "numero": 1,
  "moneda": "PYG",
  "tipoDocumento": 1,
  "tipoEmision": 1,
  "tipoTransaccion": 1,
  "receiptid": "INV-001",
  "ruc": "1234567-8",
  "nombre": "Cliente Ejemplo",
  "cpais": "PYG",
  "codigoSeguridadAleatorio": 123456789,
  "items": [],
  "tipoPago": 1,
  "monto": 0,
  "totalPago": 0,
  "totalRedondeo": 0,
  "pais": "PYG"
}

📄 Ejemplo: Factura Simple

Este ejemplo muestra cómo crear una factura simple con un producto:

Factura Simple - Contado JSON

{
  "fecha": "2024-01-15T10:30:00",
  "punto": 1,
  "numero": 1,
  "moneda": "PYG",
  "tipoDocumento": 1,
  "tipoEmision": 1,
  "tipoTransaccion": 1,
  "receiptid": "FACT-001-2024",
  "ruc": "1234567-8",
  "nombre": "Empresa Cliente S.A.",
  "cpais": "PYG",
  "codigoSeguridadAleatorio": 987654321,
  "items": [
    {
      "descripcion": "Producto de Ejemplo",
      "codigo": "PROD001",
      "tipoIva": 5,
      "unidadMedida": 7,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 2,
      "precioUnitario": 50000,
      "precioTotal": 100000,
      "baseGravItem": 100000,
      "liqIvaItem": 10000
    }
  ],
  "tipoPago": 1,
  "monto": 110000,
  "totalPago": 110000,
  "totalRedondeo": 0,
  "pais": "PYG"
}

Campos Importantes

tipoDocumento: 1 = Factura, 5 = Nota de Crédito
tipoIva: 5 = Productos gravados con IVA
unidadMedida: 7 = Unidad (consultar tabla oficial)
ivaAfecta: 1 = Sí está sujeto a IVA, 0 = No

📝 Ejemplo: Nota de Crédito

Para crear una nota de crédito, necesitas incluir el campo cdcAsociado:

Nota de Crédito JSON

{
  "fecha": "2024-01-16T14:20:00",
  "cdcAsociado": "12345678901234567890123456789012345678901234",
  "punto": 1,
  "numero": 1,
  "moneda": "PYG",
  "tipoDocumento": 5,
  "tipoEmision": 1,
  "tipoTransaccion": 1,
  "receiptid": "NC-001-2024",
  "ruc": "1234567-8",
  "nombre": "Empresa Cliente S.A.",
  "cpais": "PYG",
  "codigoSeguridadAleatorio": 123987456,
  "items": [
    {
      "descripcion": "Devolución - Producto de Ejemplo",
      "codigo": "PROD001",
      "tipoIva": 5,
      "unidadMedida": 7,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 1,
      "precioUnitario": -50000,
      "precioTotal": -50000,
      "baseGravItem": -50000,
      "liqIvaItem": -5000
    }
  ],
  "tipoPago": 1,
  "monto": -55000,
  "totalPago": -55000,
  "totalRedondeo": 0,
  "pais": "PYG"
}

Notas Importantes

cdcAsociado: Es el código de control de la factura original
tipoDocumento: Debe ser 5 para nota de crédito
Valores negativos: Los montos deben ser negativos

💳 Tipos de Pago Completos

Según el manual técnico de SIFEN, estos son todos los tipos de pago soportados:

Efectivo (1)

Pago en efectivo

Más común

Tarjeta de Crédito (2)

Pago con tarjeta de crédito

Digital

Transferencia Bancaria (3)

Transferencia entre bancos

Electrónico

Cheque (4)

Pago con cheque

Tradicional

Tarjeta de Débito (5)

Pago con tarjeta de débito

Digital

Monedero Electrónico (6)

Pago con monedero digital

Digital

Ejemplos de Implementación por Tipo de Pago

Efectivo - Factura Simple JSON

{
  "fecha": "2024-01-15T10:30:00",
  "punto": 1,
  "numero": 1,
  "moneda": "PYG",
  "tipoDocumento": 1,
  "tipoEmision": 1,
  "tipoTransaccion": 1,
  "receiptid": "FACT-EFECTIVO-001",
  "ruc": "1234567-8",
  "nombre": "Cliente Efectivo S.A.",
  "cpais": "PYG",
  "codigoSeguridadAleatorio": 111111111,
  "items": [
    {
      "descripcion": "Producto - Pago Efectivo",
      "codigo": "PROD001",
      "tipoIva": 5,
      "unidadMedida": 7,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 1,
      "precioUnitario": 100000,
      "precioTotal": 100000,
      "baseGravItem": 100000,
      "liqIvaItem": 10000
    }
  ],
  "tipoPago": 1,
  "monto": 110000,
  "totalPago": 110000,
  "totalRedondeo": 0,
  "pais": "PYG"
}

Tarjeta de Crédito - Factura JSON

{
  "fecha": "2024-01-15T14:20:00",
  "punto": 1,
  "numero": 2,
  "moneda": "PYG",
  "tipoDocumento": 1,
  "tipoEmision": 1,
  "tipoTransaccion": 1,
  "receiptid": "FACT-TC-002",
  "ruc": "2345678-9",
  "nombre": "Cliente Tarjeta Crédito",
  "cpais": "PYG",
  "codigoSeguridadAleatorio": 222222222,
  "items": [
    {
      "descripcion": "Servicio Premium - Tarjeta Crédito",
      "codigo": "SERV001",
      "tipoIva": 5,
      "unidadMedida": 7,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 1,
      "precioUnitario": 250000,
      "precioTotal": 250000,
      "baseGravItem": 250000,
      "liqIvaItem": 25000
    }
  ],
  "tipoPago": 2,
  "monto": 275000,
  "totalPago": 275000,
  "totalRedondeo": 0,
  "pais": "PYG"
}

Transferencia Bancaria JSON

{
  "fecha": "2024-01-15T16:45:00",
  "punto": 1,
  "numero": 3,
  "moneda": "PYG",
  "tipoDocumento": 1,
  "tipoEmision": 1,
  "tipoTransaccion": 1,
  "receiptid": "FACT-TRANSFER-003",
  "ruc": "3456789-0",
  "nombre": "Empresa Transferencia S.A.",
  "cpais": "PYG",
  "codigoSeguridadAleatorio": 333333333,
  "items": [
    {
      "descripcion": "Producto Empresarial",
      "codigo": "PROD-EMP001",
      "tipoIva": 5,
      "unidadMedida": 7,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 5,
      "precioUnitario": 80000,
      "precioTotal": 400000,
      "baseGravItem": 400000,
      "liqIvaItem": 40000
    }
  ],
  "tipoPago": 3,
  "monto": 440000,
  "totalPago": 440000,
  "totalRedondeo": 0,
  "pais": "PYG"
}

Pago con Cheque JSON

{
  "fecha": "2024-01-15T09:15:00",
  "punto": 1,
  "numero": 4,
  "moneda": "PYG",
  "tipoDocumento": 1,
  "tipoEmision": 1,
  "tipoTransaccion": 1,
  "receiptid": "FACT-CHEQUE-004",
  "ruc": "4567890-1",
  "nombre": "Cliente Cheque S.R.L.",
  "cpais": "PYG",
  "codigoSeguridadAleatorio": 444444444,
  "items": [
    {
      "descripcion": "Servicio Consultoría",
      "codigo": "CONS001",
      "tipoIva": 5,
      "unidadMedida": 7,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 1,
      "precioUnitario": 500000,
      "precioTotal": 500000,
      "baseGravItem": 500000,
      "liqIvaItem": 50000
    }
  ],
  "tipoPago": 4,
  "monto": 550000,
  "totalPago": 550000,
  "totalRedondeo": 0,
  "pais": "PYG"
}

Tarjeta de Débito JSON

{
  "fecha": "2024-01-15T11:30:00",
  "punto": 1,
  "numero": 5,
  "moneda": "PYG",
  "tipoDocumento": 1,
  "tipoEmision": 1,
  "tipoTransaccion": 1,
  "receiptid": "FACT-TD-005",
  "ruc": "5678901-2",
  "nombre": "Cliente Débito S.A.",
  "cpais": "PYG",
  "codigoSeguridadAleatorio": 555555555,
  "items": [
    {
      "descripcion": "Producto - Débito",
      "codigo": "PROD-DEB001",
      "tipoIva": 5,
      "unidadMedida": 7,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 3,
      "precioUnitario": 120000,
      "precioTotal": 360000,
      "baseGravItem": 360000,
      "liqIvaItem": 36000
    }
  ],
  "tipoPago": 5,
  "monto": 396000,
  "totalPago": 396000,
  "totalRedondeo": 0,
  "pais": "PYG"
}

Monedero Electrónico JSON

{
  "fecha": "2024-01-15T15:20:00",
  "punto": 1,
  "numero": 6,
  "moneda": "PYG",
  "tipoDocumento": 1,
  "tipoEmision": 1,
  "tipoTransaccion": 1,
  "receiptid": "FACT-MONEDERO-006",
  "ruc": "6789012-3",
  "nombre": "Cliente Digital S.A.",
  "cpais": "PYG",
  "codigoSeguridadAleatorio": 666666666,
  "items": [
    {
      "descripcion": "Servicio Digital",
      "codigo": "DIG001",
      "tipoIva": 5,
      "unidadMedida": 7,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 1,
      "precioUnitario": 75000,
      "precioTotal": 75000,
      "baseGravItem": 75000,
      "liqIvaItem": 7500
    }
  ],
  "tipoPago": 6,
  "monto": 82500,
  "totalPago": 82500,
  "totalRedondeo": 0,
  "pais": "PYG"
}

🔧 Ejemplos Prácticos

Factura Mixta (Múltiples Productos)

Factura Completa - Varios Items JSON

{
  "fecha": "2024-01-15T12:00:00",
  "punto": 1,
  "numero": 10,
  "moneda": "PYG",
  "tipoDocumento": 1,
  "tipoEmision": 1,
  "tipoTransaccion": 1,
  "receiptid": "FACT-MIXTA-010",
  "ruc": "1234567-8",
  "nombre": "Supermercado El Ahorro S.A.",
  "cpais": "PYG",
  "codigoSeguridadAleatorio": 999999999,
  "items": [
    {
      "descripcion": "Arroz Premium 1kg",
      "codigo": "ARR001",
      "tipoIva": 5,
      "unidadMedida": 7,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 2,
      "precioUnitario": 15000,
      "precioTotal": 30000,
      "baseGravItem": 30000,
      "liqIvaItem": 3000
    },
    {
      "descripcion": "Aceite de Girasol 900ml",
      "codigo": "ACE001",
      "tipoIva": 5,
      "unidadMedida": 7,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 1,
      "precioUnitario": 25000,
      "precioTotal": 25000,
      "baseGravItem": 25000,
      "liqIvaItem": 2500
    },
    {
      "descripcion": "Pan Lactal Integral",
      "codigo": "PAN001",
      "tipoIva": 5,
      "unidadMedida": 7,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 3,
      "precioUnitario": 8000,
      "precioTotal": 24000,
      "baseGravItem": 24000,
      "liqIvaItem": 2400
    },
    {
      "descripcion": "Leche Descremada 1L",
      "codigo": "LEC001",
      "tipoIva": 5,
      "unidadMedida": 7,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 2,
      "precioUnitario": 12000,
      "precioTotal": 24000,
      "baseGravItem": 24000,
      "liqIvaItem": 2400
    }
  ],
  "tipoPago": 2,
  "monto": 103900,
  "totalPago": 103900,
  "totalRedondeo": 0,
  "pais": "PYG"
}

Factura de Servicios

Factura de Servicios Profesionales JSON

{
  "fecha": "2024-01-15T08:00:00",
  "punto": 1,
  "numero": 15,
  "moneda": "PYG",
  "tipoDocumento": 1,
  "tipoEmision": 1,
  "tipoTransaccion": 1,
  "receiptid": "FACT-SERVICIOS-015",
  "ruc": "9876543-2",
  "nombre": "Empresa Contratante S.A.",
  "cpais": "PYG",
  "codigoSeguridadAleatorio": 888888888,
  "items": [
    {
      "descripcion": "Consultoría en Sistemas - 20 horas",
      "codigo": "CONS-SIST001",
      "tipoIva": 5,
      "unidadMedida": 2,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 20,
      "precioUnitario": 150000,
      "precioTotal": 3000000,
      "baseGravItem": 3000000,
      "liqIvaItem": 300000
    },
    {
      "descripcion": "Desarrollo de Aplicación Web",
      "codigo": "DES-WEB001",
      "tipoIva": 5,
      "unidadMedida": 7,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 1,
      "precioUnitario": 5000000,
      "precioTotal": 5000000,
      "baseGravItem": 5000000,
      "liqIvaItem": 500000
    }
  ],
  "tipoPago": 3,
  "monto": 8800000,
  "totalPago": 8800000,
  "totalRedondeo": 0,
  "pais": "PYG"
}

Consejos para Ejemplos Prácticos

Códigos únicos: Usa códigos de seguridad aleatorios únicos por documento
Secuencias: Mantén la secuencia de números por punto de expedición
Unidades de medida: 2 = Horas, 7 = Unidad, consultar tabla oficial
Cálculos: Siempre verifica que los totales coincidan
RUC: Formato: 1234567-8 (7-8 dígitos + 1 dígito verificador)

📋 Documentación Completa de Campos

Campos Principales del Documento

Esta tabla contiene todos los campos principales que puedes usar en tu JSON para crear facturas y notas de crédito:

Campo	Tipo	Descripción	Ejemplo
fecha	string	Fecha de emisión del documento en formato AAAA-MM-DD	"2024-01-15"
fecha/hora	string	Fecha y hora de emisión en formato AAAA-MM-DDTHH:mm:ss	"2024-01-15T10:30:00"
cdcAsociado	string	En caso de nota de crédito, el número del documento al que corresponde	"12345678901234567890123456789012345678901234"
punto	integer	Punto de expedición del documento	1
numero	integer	Número de documento	1
moneda	string	Moneda utilizada según tabla del manual técnico SIFEN	"PYG"
tipoDocumento	integer	Tipo de documento: 1 = factura, 5 = nota de crédito	1
tipoEmision	integer	Tipo de emisión: 1 = normal, 2 = contingencia	1
tipoTransaccion	integer	Tipo de transacción según tabla del manual técnico SIFEN	1
receiptid	string	ID interno del sistema cliente	"FACT-001-2024"
ruc	string	RUC del cliente	"1234567-8"
nombre	string	Nombre del cliente	"Empresa Cliente S.A."
cpais	string	País del cliente. Solo se acepta PYG	"PYG"
codigoSeguridadAleatorio	integer	Código de seguridad aleatorio de 9 dígitos no repetido por punto	123456789
items	array	Detalles de los productos o servicios incluidos en la factura	Ver estructura de items
tipoPago	integer	Tipo de pago según tabla del manual técnico SIFEN	1
monto	number	Monto total de la transacción	110000
totalPago	number	Monto total de la transacción	110000
totalRedondeo	number	Valor del redondeo de la transacción	0
pais	string	País de la transacción. Solo se acepta PYG	"PYG"

Estructura de Items (Productos/Servicios)

Campo	Tipo	Descripción	Requerido
descripcion	string	Descripción del producto o servicio	✅
codigo	string	Código del producto o servicio	✅
tipoIva	integer	Tipo de IVA del producto o servicio	✅
unidadMedida	integer	Unidad de medida del producto o servicio	✅
ivaTasa	number	Tasa de IVA aplicada al producto o servicio	✅
ivaAfecta	integer	Indica si está sujeto a IVA: 1 = sí, 0 = no	✅
cantidad	number	Cantidad de unidades del producto o servicio	✅
precioUnitario	number	Precio unitario del producto o servicio	✅
precioTotal	number	Precio total (cantidad × precio unitario)	✅
baseGravItem	number	Base gravable del producto o servicio	✅
liqIvaItem	number	Valor del IVA calculado sobre el producto o servicio	✅

Tipos de Pago SIFEN

1 - Efectivo

Pago en efectivo

Más común

2 - Tarjeta de Crédito

Pago con tarjeta de crédito

Digital

3 - Transferencia Bancaria

Transferencia entre bancos

Electrónico

4 - Cheque

Pago con cheque

Tradicional

5 - Tarjeta de Débito

Pago con tarjeta de débito

Digital

6 - Monedero Electrónico

Pago con monedero digital

Digital

Tipos de Documento

1: Factura - Documento principal de venta
5: Nota de Crédito - Para devoluciones o correcciones

Tipos de IVA Comunes

5: Productos gravados con IVA (10%)
0: Productos exentos de IVA
1: Productos con IVA 0%

Unidades de Medida Comunes

2: Horas (para servicios)
7: Unidad (para productos)
1: Kilogramo
3: Metro
4: Litro

⚡ Procesamiento en Tiempo Real

Procesamiento en Tiempo Real

Generación y envío de facturas electrónicas en segundos con confirmación automática del SIFEN. Validación instantánea de documentos.

Ve cómo Json-Api procesa y genera facturas electrónicas en tiempo real. Cada paso del proceso se ejecuta en milisegundos, garantizando la máxima eficiencia y cumplimiento normativo.

Simulación: Facturación en Tiempo Real

1. Recepción de Datos

Json-Api recibe los datos de la factura

POST /api/invoice

0.1s

2. Validación Instantánea

Validación instantánea de documentos: formato, RUC, datos obligatorios y cálculos

✓ RUC válido ✓ Datos completos ✓ Totales correctos ✓ Formato SIFEN

0.3s

3. Envío a SIFEN

Transmisión segura al Sistema SIFEN

https://ekuatia.set.gov.py/ws

0.8s

4. Confirmación Automática SIFEN

Confirmación automática del SIFEN - respuesta oficial del sistema gubernamental

✓ Documento aceptado CDC: 12345678901234567890 ✓ SIFEN confirmado

1.2s

5. Generación de PDF

Creación automática del documento PDF

PDF generado QR incluido

1.5s

6. Notificación al Cliente

Envió automático por email al cliente

✓ Email enviado cliente@empresa.com

2.0s

¡Procesamiento en Tiempo Real Completado!

Generación y envío de facturas electrónicas en segundos con confirmación automática del SIFEN. Validación instantánea de documentos.

2.0 segundos

100% éxito

SIFEN confirmado

⚡ tiempo real

Ejemplo Práctico: Procesamiento en Tiempo Real

⚡ Ejemplo: Factura en Tiempo Real JSON

{
  "fecha": "2024-01-15T14:30:00",
  "punto": 1,
  "numero": 25,
  "moneda": "PYG",
  "tipoDocumento": 1,
  "tipoEmision": 1,
  "tipoTransaccion": 1,
  "receiptid": "TIEMPO-REAL-025",
  "ruc": "8765432-1",
  "nombre": "EMPRESA PROCESAMIENTO RÁPIDO S.A.",
  "cpais": "PYG",
  "codigoSeguridadAleatorio": 987123456,
  "items": [
    {
      "descripcion": "SERVICIO DE CONSULTORÍA TÉCNICA - PROCESAMIENTO RÁPIDO",
      "codigo": "SERV-TR-001",
      "tipoIva": 3,
      "unidadMedida": 2,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 4,
      "precioUnitario": 200000,
      "precioTotal": 800000,
      "baseGravItem": 800000,
      "liqIvaItem": 80000
    },
    {
      "descripcion": "DESARROLLO DE SOFTWARE - FACTURACIÓN ELECTRÓNICA",
      "codigo": "SOFT-TR-002",
      "tipoIva": 3,
      "unidadMedida": 7,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 1,
      "precioUnitario": 1500000,
      "precioTotal": 1500000,
      "baseGravItem": 1500000,
      "liqIvaItem": 150000
    }
  ],
  "tipoPago": 2,
  "monto": 2530000,
  "totalPago": 2530000,
  "totalRedondeo": 0,
  "pais": "PYG"
}

Implementación en PHP - Procesamiento en Tiempo Real

PHP: Cliente para Procesamiento en Tiempo Real PHP

❌ Error: Validación fallida: Los totales no coinciden

Respuesta de la API - Tiempo Real

Respuesta: Procesamiento en Tiempo Real JSON

{
  "status": "success",
  "message": "Procesamiento en tiempo real completado",
  "data": {
    "cdc": "98712345678901234567890123456789012345678901",
    "pdf_url": "https://api.json-api.com/invoices/001-025-00000025.pdf",
    "qr_code": "https://ekuatia.set.gov.py/consulta?cdc=98712345678901234567890123456789012345678901",
    "processing_time": "1847ms",
    "sifen_confirmed": true,
    "timestamp": "2024-01-15T14:30:02Z",
    "validation_results": {
      "ruc_valid": true,
      "format_valid": true,
      "totals_correct": true,
      "sifen_compatible": true
    },
    "performance_metrics": {
      "validation_time": "45ms",
      "sifen_transmission": "1200ms",
      "pdf_generation": "400ms",
      "email_notification": "202ms"
    }
  }
}

Ventajas del Procesamiento en Tiempo Real

⚡ Generación en Segundos: Menos de 2 segundos por factura
🔒 Confirmación Automática SIFEN: Validación instantánea gubernamental
✅ Validación Instantánea: Verificación inmediata de documentos
🤖 Automatización Total: Sin intervención manual requerida
📧 Notificaciones Automáticas: Email instantáneo al cliente
📊 Trazabilidad Completa: Log detallado de cada operación

Métricas de Rendimiento

Validación: ~45ms promedio
Transmisión SIFEN: ~1200ms promedio
Generación PDF: ~400ms promedio
Notificación Email: ~200ms promedio
Total: ~1.8 segundos promedio
Disponibilidad: 99.9% uptime

🏛️ Datos Técnicos Oficiales SIFEN

Información Oficial DNIT

Esta sección contiene datos técnicos específicos del Sistema Integrado de Facturación Electrónica Nacional (SIFEN) de Paraguay, según las normativas oficiales de la Dirección Nacional de Impuestos (DNIT).

Códigos de Tipo de Documento SIFEN

Código	Descripción	Tipo	Uso
1	Factura	Venta	Documento principal de venta
2	Nota de Débito	Ajuste	Para incrementar el monto de una factura
3	Nota de Crédito	Ajuste	Para disminuir el monto de una factura
4	Remisión	Venta	Documento de entrega de mercaderías
5	Comprobante de Pago	Pago	Documento de pago de servicios
6	Comprobante de Retención	Retención	Documento de retención de impuestos
7	Comprobante de Pago de Exportación	Exportación	Para exportaciones
8	Exportación	Exportación	Documento de exportación

Códigos de Tipo de Transacción SIFEN

Código	Descripción	Descripción Completa
1	Venta	Venta de bienes o servicios
2	Prestación de Servicios	Servicios profesionales o técnicos
3	Mixto	Venta de bienes y servicios
4	Venta de Activos	Venta de activos fijos
5	Exportación	Venta al exterior
6	Importación	Compra del exterior

Códigos de Tipo de Emisión

1 - Emisión Normal

Emisión en condiciones normales de funcionamiento del sistema SIFEN

Recomendado

2 - Emisión en Contingencia

Emisión cuando el sistema SIFEN está fuera de servicio

Solo emergencias

Códigos de Moneda SIFEN

Código	Moneda	País	Uso en Paraguay
PYG	Guaraní Paraguayo	Paraguay	✅ Moneda oficial
USD	Dólar Americano	Estados Unidos	✅ Exportaciones
EUR	Euro	Unión Europea	⚠️ Exportaciones específicas
BRL	Real Brasileño	Brasil	⚠️ Exportaciones específicas
ARS	Peso Argentino	Argentina	⚠️ Exportaciones específicas

Códigos de Tipo de IVA SIFEN

Código	Descripción	Tasa IVA	Aplicación
0	Exento	0%	Productos exentos por ley
1	Gravado IVA 0%	0%	Productos gravados pero con tasa 0%
2	Gravado IVA 5%	5%	Productos de primera necesidad
3	Gravado IVA 10%	10%	Tasa general de IVA
4	Gravado IVA 15%	15%	Productos específicos (bebidas, tabaco)
5	Gravado IVA Variable	Variable	Productos con tasa variable

Códigos de Unidad de Medida SIFEN

Código	Descripción	Símbolo	Uso Común
1	Kilogramo	kg	Peso de productos sólidos
2	Hora	h	Servicios por tiempo
3	Metro	m	Longitud lineal
4	Litro	L	Volumen de líquidos
5	Metro Cuadrado	m²	Área de superficies
6	Metro Cúbico	m³	Volumen de sólidos
7	Unidad	u	Productos por unidad
8	Par	par	Productos vendidos en pares
9	Docena	doc	Productos por docena
10	Centena	cen	Productos por centena

Validaciones Técnicas SIFEN

Validaciones Obligatorias

RUC: Formato 1234567-8 (7-8 dígitos + guión + 1 dígito verificador)
Fecha: Debe ser fecha actual o anterior (no futuras)
Código de Seguridad: 9 dígitos únicos por punto de expedición
Secuencia: Números correlativos por punto de expedición
Totales: Monto = Suma de items + IVA
Items: Mínimo 1 item por documento

URLs y Endpoints Oficiales SIFEN

Endpoints SIFEN de Producción URL

# SIFEN Producción
https://ekuatia.set.gov.py/ws

# SIFEN Pruebas
https://ekuatia.set.gov.py/ws-test

# DNIT Portal Oficial
https://www.dnit.gov.py/web/portal-institucional/factura-electronica

# Manual Técnico SIFEN
https://www.dnit.gov.py/web/portal-institucional/factura-electronica/manual-tecnico

# Tabla de Códigos Oficiales
https://www.dnit.gov.py/web/portal-institucional/factura-electronica/codigos-oficiales

Ejemplo Completo con Validaciones SIFEN

Factura con Datos Técnicos SIFEN JSON

{
  "fecha": "2024-01-15T10:30:00",
  "punto": 1,
  "numero": 1,
  "moneda": "PYG",
  "tipoDocumento": 1,
  "tipoEmision": 1,
  "tipoTransaccion": 1,
  "receiptid": "FACT-SIFEN-001-2024",
  "ruc": "1234567-8",
  "nombre": "EMPRESA EJEMPLO S.A.",
  "cpais": "PYG",
  "codigoSeguridadAleatorio": 987654321,
  "items": [
    {
      "descripcion": "SERVICIO DE CONSULTORIA TECNICA",
      "codigo": "SERV-001",
      "tipoIva": 3,
      "unidadMedida": 2,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 8,
      "precioUnitario": 150000,
      "precioTotal": 1200000,
      "baseGravItem": 1200000,
      "liqIvaItem": 120000
    },
    {
      "descripcion": "PRODUCTO TECNOLOGICO",
      "codigo": "PROD-002",
      "tipoIva": 3,
      "unidadMedida": 7,
      "ivaTasa": 10,
      "ivaAfecta": 1,
      "cantidad": 2,
      "precioUnitario": 500000,
      "precioTotal": 1000000,
      "baseGravItem": 1000000,
      "liqIvaItem": 100000
    }
  ],
  "tipoPago": 3,
  "monto": 2420000,
  "totalPago": 2420000,
  "totalRedondeo": 0,
  "pais": "PYG"
}

Datos Técnicos Clave para Desarrolladores

Timeout SIFEN: 30 segundos máximo por petición
Límite de Items: Máximo 1000 items por documento
Encoding: UTF-8 obligatorio para caracteres especiales
Content-Type: application/json
Certificados: Firma electrónica DNIT requerida
Backup: Mantener respaldo de documentos por 10 años

💡 Mejores Prácticas

Recomendaciones de Implementación

Validación: Siempre valida los datos antes de enviar
Códigos únicos: Usa códigos de seguridad aleatorios únicos
Secuencias: Mantén la secuencia de números por punto de expedición
Manejo de errores: Implementa manejo robusto de errores
Logs: Registra todas las operaciones para auditoría

Ejemplo de Validación en PHP

Validación de Datos PHP

Datos válidos, proceder con el envío

🚀 ¡Implementa Tu Facturación Electrónica!

¿Listo para Automatizar tu Facturación?

No pierdas más tiempo con facturación manual. Nuestro equipo de expertos en SIFEN puede ayudarte a implementar Json-Api en tu sistema en menos de 24 horas.

Consulta Gratuita

Habla directamente con nuestros especialistas en facturación electrónica

WhatsApp: +595 992 625 873

Email Directo

Envíanos tus requerimientos y te responderemos en menos de 2 horas

ventas@facturacionelectronica.com.py

¿Por Qué Elegirnos?

Implementación Rápida

Menos de 24 horas para tener todo funcionando

Certificado DNIT

Totalmente compatible con SIFEN y normativas oficiales

Soporte 24/7

Asistencia técnica cuando la necesites

Visítanos

Nuestra oficina está ubicada en el corazón de Asunción, fácil acceso y estacionamiento disponible.

Tte. Moreno Esq. Rodis Segovia Nª 1907

¿Tienes dudas técnicas?

Nuestro equipo de desarrolladores está listo para resolver cualquier consulta sobre Json-Api

Formulario de Contacto Ver Nuestros Servicios

Índice del Tutorial

📖 Introducción

¿Qué es Json-Api?

Características Principales

⚙️ Configuración Inicial

1. Endpoint de la API

2. Estructura Básica de la Petición

📄 Ejemplo: Factura Simple

Campos Importantes

📝 Ejemplo: Nota de Crédito

Notas Importantes

💳 Tipos de Pago Completos

Efectivo (1)

Tarjeta de Crédito (2)

Transferencia Bancaria (3)

Cheque (4)

Tarjeta de Débito (5)

Monedero Electrónico (6)

Ejemplos de Implementación por Tipo de Pago

🔧 Ejemplos Prácticos

Factura Mixta (Múltiples Productos)

Factura de Servicios

Consejos para Ejemplos Prácticos

📋 Documentación Completa de Campos

Campos Principales del Documento

Estructura de Items (Productos/Servicios)

Tipos de Pago SIFEN

1 - Efectivo

2 - Tarjeta de Crédito

3 - Transferencia Bancaria

4 - Cheque

5 - Tarjeta de Débito

6 - Monedero Electrónico

Tipos de Documento

Tipos de IVA Comunes

Unidades de Medida Comunes

⚡ Procesamiento en Tiempo Real

Procesamiento en Tiempo Real

Simulación: Facturación en Tiempo Real

1. Recepción de Datos

2. Validación Instantánea

3. Envío a SIFEN

4. Confirmación Automática SIFEN

5. Generación de PDF

6. Notificación al Cliente

¡Procesamiento en Tiempo Real Completado!

Ejemplo Práctico: Procesamiento en Tiempo Real

Implementación en PHP - Procesamiento en Tiempo Real

Respuesta de la API - Tiempo Real

Ventajas del Procesamiento en Tiempo Real

Métricas de Rendimiento

🏛️ Datos Técnicos Oficiales SIFEN

Información Oficial DNIT

Códigos de Tipo de Documento SIFEN

Códigos de Tipo de Transacción SIFEN

Códigos de Tipo de Emisión

1 - Emisión Normal

2 - Emisión en Contingencia

Códigos de Moneda SIFEN

Códigos de Tipo de IVA SIFEN

Códigos de Unidad de Medida SIFEN

Validaciones Técnicas SIFEN

Validaciones Obligatorias

URLs y Endpoints Oficiales SIFEN

Ejemplo Completo con Validaciones SIFEN

Datos Técnicos Clave para Desarrolladores

💡 Mejores Prácticas

Recomendaciones de Implementación

Ejemplo de Validación en PHP

🚀 ¡Implementa Tu Facturación Electrónica!

¿Listo para Automatizar tu Facturación?

Consulta Gratuita

Email Directo

¿Por Qué Elegirnos?

Implementación Rápida

Certificado DNIT

Soporte 24/7

Visítanos

¿Tienes dudas técnicas?