5. FORMATO Y ESTRUCTURA

La API sigue un formato específico para procesar la información relacionada con los documentos de ventas. A continuación se detalla la estructura del JSON que debe enviarse al endpoint correspondiente para realizar operaciones relacionadas con los documentos.

Factura Electrónica:

El JSON enviado debe contener los siguientes campos:

Campo	Tipo	Requerido	Descripción
tipoDocumento	Número	Obligatorio	Identifica el tipo de documento. 1= Factura electrónica, 4= Autofactura electrónica 5= Nota de crédito electrónica, 6= Nota de débito electrónica, 7= Nota de remisión electrónica. Máximo de 1 dígito.
establecimiento	Número	Obligatorio	Número de establecimiento. Máximo de 3 dígitos.
punto	Número	Obligatorio	Número de punto de venta. Máximo de 3 dígitos.
numero	Número	Obligatorio	Número de la factura. Máximo de 8 dígitos.
fecha	Fecha y hora	Obligatorio	Fecha y hora de emisión de la factura en formato YYYY-MM-DDTHH:mm:ss.
observacion	Texto	Opcional	Observaciones adicionales sobre la factura. Máximo 250 caracteres
vendedor	Texto	Obligatorio	Nombre o razón social del vendedor Máximo de 100 caracteres.
moneda	Texto	Opcional	Moneda de la venta. Por defecto PYG
cambio	Número	Opcional	Tipo de cambio de la venta. Por defecto 1, Obligatorio si moneda ≠ PYG

receptor

Objeto con la información del receptor. Obligatorio

Campo	Tipo	Requerido	Descripción
ruc	Número	Obligatorio	Número de RUC del receptor. Máximo de 11 dígitos.
tipoID	Número	Opcional	Tipo de identificación del receptor: 1 para Cédula de Identidad, 2 para RUC. Máximo de 1 dígito.
numID	Número	Opcional	Obligatorio si tipoID = 1 Número de identificación o cédula de Identidad del receptor. Máximo de 15 dígitos.
nombre	Texto	Obligatorio	Nombre o razón social del receptor. Máximo de 100 caracteres.
direccion	Texto	Obligatorio	Dirección del receptor. Máximo de 100 caracteres.
numero	Número	Obligatorio	Número de la dirección del receptor. Máximo de 5 dígitos.
ciudad	Código	Obligatorio	Código de la ciudad del receptor. Máximo de 3 caracteres.
email	Correo electrónico	Opcional	Correo electrónico del receptor. Máximo de 50 caracteres.

items

Array de objetos con la información de cada ítem. Obligatorio

Campo	Tipo	Requerido	Descripción
codigo	Texto	Obligatorio	Código del ítem. Máximo de 20 caracteres.
descripcion	Texto	Obligatorio	Descripción del ítem. Máximo de 100 caracteres.
unidad	Número	Obligatorio	Unidad de medida del ítem. Máximo de 3 dígitos.
cantidad	Número	Obligatorio	Cantidad del ítem. Máximo de 10 dígitos.
unitario	Número	Obligatorio	Precio unitario del ítem. Máximo de 15 dígitos enteros y 2 decimales.
descuento	Número	Opcional	Monto de descuento aplicado al ítem. Máximo de 15 dígitos enteros y 2 decimales.
tasaIVA	Número	Obligatorio	Tasa de IVA aplicable al ítem. Máximo de 3 dígitos.
valor	Número	Obligatorio	Precio total del ítem (cantidad * unitario - descuento). Máximo de 15 dígitos enteros y 2 decimales.

descuento

Objeto con información sobre el descuento aplicado a la factura. Opcional

Campo	Tipo	Requerido	Descripción
monto	Número	Obligatorio	Monto total del descuento. Máximo de 15 dígitos enteros y 2 decimales.
motivo	Texto	Obligatorio	Descripción del motivo del descuento. Máximo de 100 caracteres.
porcentaje	Número	Opcional	Porcentaje de descuento aplicado (opcional). Máximo de 5 dígitos enteros y 2 decimales.

pago

Array de objetos con la información de cada forma de pago. Obligatorio

Campo	Tipo	Requerido	Descripción
condicion	Número	Obligatorio	Identifica si el pago es contado o crédito 1: Contado - 2: Crédito
tipoPago	Número	Obligatorio	Número que identifica el tipo de pago. 1 para efectivo. Obligatorio si "condicion" = 1
tipoCredito	Número	Opcional	Identifica el tipo de crédito 1: Plazo - 2: Cuota Obligatorio si "condicion" = 2
plazo	Número	Opcional	Número que representa el plazo en días Obligatorio si "tipoCredito" = 1
cuotas	Número	Opcional	Número que representa la cantidad de cuotas Obligatorio si "tipoCredito" = 2
monto	Número	Obligatorio	Monto del pago. Máximo de 15 enteros y 2 decimales.

docAsociado

Array de objetos con información sobre documentos asociados a la factura. Opcional

Campo	Tipo	Requerido	Descripción
tipoDocAso	Número	Obligatorio	Tipo de documento asociado. 200 para Nota de Crédito. Máximo de 3 dígitos.
numero	Texto	Obligatorio	Número del documento asociado. Máximo de 20 caracteres.

Ejemplo de JSON

{
  "tipoDocumento": 1,
  "establecimiento": 1,
  "punto": 1,
  "numero": 0,
  "fecha": "2023-11-14T12:12:12",
  "observacion": "factura de prueba",
  "vendedor": "CLAUDIO CAMILO",
  "moneda": "PYG",
  "cambio": 1,
  "receptor": {
    "ruc": "99999999-0",
    "tipoID": 2,
    "numID": "12345678",
    "nombre": "COMERCIAL CERRITO",
    "direccion": "San Juan De La Cruz",
    "numero": 5422,
    "ciudad": 990,
    "email": "[email protected]"
  },
  "items": [{
    "codigo": "PVC-110S",
    "descripcion": "Producto 1",
    "unidad": 77,
    "cantidad": 1,
    "unitario": 8000,
    "descuento": 800,
    "tasaIVA": 10,
    "valor": 7200
  }, {
    "codigo": "PVC-110P",
    "descripcion": "Producto 2",
    "unidad": 83,
    "cantidad": 3,
    "unitario": 4000,
    "tasaIVA": 10,
    "valor": 12000
  }],
  "descuento": {
    "monto": 1200,
    "motivo": "DESCUENTO PREMIUM",
    "porcentaje": 0
  },
  "pago": [{
      "condicion": 1,
      "tipoPago": 1,
      "monto": 19200
  }],
  "docAsociado": [{
      "tipoDocAso": 200,
      "numero": "001-001-0000012"
    }
  ]
}