Factura Contado
La factura de contado es el documento electrónico más común. Se utiliza cuando el pago se realiza en el momento de la transacción.
Condición de Pago
Para factura de contado, el campo condicionPago debe ser igual a 1
Estructura del JSON
El JSON para crear una factura de contado se compone de tres partes principales:
Datos Generales
Información básica de la factura como fecha, número, tipo, etc.
Datos del Cliente
Información del receptor o cliente de la factura.
Items y Pagos
Productos o servicios y formas de pago de la transacción.
Campos Principales
fecha
string
Requerido
Fecha y hora de la factura en formato
Y-m-d H:i:s. Ejemplo: "2025-01-17 17:25:26"
establecimiento
string
Requerido
Código del establecimiento (3 dígitos). Ejemplo:
"001"
punto
string
Requerido
Punto de expedición (3 dígitos). Ejemplo:
"001"
numero
string
Requerido
Los últimos 7 dígitos del número del documento. Ejemplo:
"0000060"
tipoDocumento
integer
Requerido
Tipo de documento electrónico. Para factura usa
1. Ver tabla completa
condicionPago
integer
Requerido
Para factura de contado debe ser
1. Para crédito usa 2
moneda
string
Requerido
receiptid
string
Requerido
ID único del sistema del cliente para identificar posteriormente. No se debe repetir. Ejemplo:
"test60"
Ejemplo de JSON Factura Contado
JSON
{
"fecha": "2025-01-17 17:25:26",
"establecimiento": "001",
"punto": "001",
"numero": "0000060",
"descripcion": "Información de interes por parte del emisor",
"tipoDocumento": 1,
"tipoEmision": 1,
"tipoTransaccion": 1,
"receiptid": "test60",
"condicionPago": 1,
"moneda": "PYG",
"cambio": 0,
"cliente": {
"ruc": "44444-1",
"nombre": "NOMBRE CLIENTE",
"direccion": "N/A",
"cpais": "PRY",
"correo": "correo@gmail.com",
"numCasa": 0,
"diplomatico": false,
"dncp": 0
},
"codigoSeguridadAleatorio": "819250260",
"items": [
{
"descripcion": "test product",
"codigo": "0011",
"unidadMedida": 77,
"ivaTasa": 10,
"ivaAfecta": 1,
"cantidad": 1,
"precioUnitario": 1000.0,
"precioTotal": 1000.0,
"baseGravItem": 909,
"liqIvaItem": 91
}
],
"pagos": [
{
"tipoPago": "1",
"monto": 1000.0
}
],
"totalPago": 1000,
"totalRedondeo": 0
}Notas Importantes
Cálculos IVA
Los campos baseGravItem y liqIvaItem no se deben redondear y deben tener hasta 8 decimales de precisión.
Código de Seguridad
El codigoSeguridadAleatorio debe ser un número aleatorio de 9 caracteres único para cada documento.
Factura sin Cliente
Si es una factura sin identificación de cliente (innominado), envía el campo ruc vacío.