Estructura JSON de un DE

Parámetro	Requerido	Descripción
tipoDocumento	Si	Uno de los 5 tipos de documentos admitidos por eKuatia (1, 4, 5, 6, 7). Ej.: 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. Campo XML: C002.
establecimiento	Si	Representa al código de establecimiento del emisor, se puede enviar 1 o ‘001’ Campo XML: C005.
punto	Si	Es el punto de emisión del documento electrónico, se puede enviar 1 o ‘001’ Campo XML: C006.
numero	Si	Es el número del documento electrónico, se puede enviar directamente el número o completar con 0 a la izquierda hasta alcanzar 7 digitos. Ej.: 1 o ‘0000001’. Campo XML:C007
serie	No	Serie de 2 digitos de la numeración del documento electrónico. Solo debe enviarse cuando se utiliza la totalidad de la numeración de 7 dígitos, empezando por la serie AA, AB, AC, BA, BB, BC…ZZ. Campo XML:C010
descripcion	No	Información de interés del Fisco respecto al DE. Campo XML: B006.
observacion	No	Información de interés del emisor respecto al DE. Campo XML: B005.
fecha	Si	Fecha y hora de emisión del DE. Campo XML: D002.
tipoEmision	No	Tipo de emisión del DE (1 o 2) Valores: 1=Normal (Por defecto). 2=Contingencia. Campo XML: B002.
tipoTransaccion	No	Tipo de Transacción. Valores: 1=Venta de mercadería (Por defecto). 2=Prestación de servicios. 3=Mixto (Venta de mercadería y servicios). 4=Venta de activo fijo. 5=Venta de divisas. 6=Compra de divisas. 7=Promoción o entrega de muestras. 8=Donación. 9=Anticipo. 10=Compra de Productos. 11=Venta de Crédito fiscal. 12=Compra de Crédito fiscal. 13=Muestras médicas (Art. 3 RG 24/2014). tipoTransaccion es obligatorio para el tipo de documento (tipoDocumento) igual a 1-Factura Electrónica o 4-AutoFactura. Campo XML: D011.
tipoImpuesto	Si	Tipo de impuesto afectado. Valores: 1=IVA. 2=ISC. 3=Renta. 4=Ninguno. 5=IVA – Renta. Campo XML: D013.
moneda	No	Código de la moneda de la operación de acuerdo con la norma ISO 4217. Si no se pasa asume el valor por defecto “PYG” Campo XML: D015.
condicionAnticipo	No	Condición del Anticipo. Valores: 1=Anticipo Global. 2=Anticipo por ítem. No es obligatorio informar. Campo XML: D019.
condicionTipoCambio	No	Condición del tipo de cambio. Valores: 1=Global (un solo tipo de cambio para todo el DE). 2=Por ítem (tipo de cambio distinto por ítem). Obligatorio si moneda ≠ PYG, Si la moneda es PYG no enviar éste atributo o enviar con el valor null. Campo XML: D017.
obligaciones	No	Obligaciones afectadas. Debe ser enviado como un array de objetos. Ver detalle en tabla data.obligaciones Campo XML: D030 – NT18.
cambio	No	Valor del cambio de la moneda de la operación en la cotización del día. Ej.: 6500.00 si la moneda es USD. Si la moneda es PYG no enviar éste campo o enviar null Campo XML: D018
cdc	No	Código CDC de 44 dígitos que desea utilizarse para el DE. En ocasiones puede ser necesario re-utilizar el mismo CDC de un DE que ha sido rechazado anteriormente, por ejemplo si el Documento KUDE ya ha sido entregado al Cliente, corrigiendo el error y volviendo a intentar la aprobación con el mismo CDC.
cliente	Si	Datos del Receptor del Documento Electrónico. Ver detalle en tabla data.cliente.
usuario	No	Campos que identifican al responsable de la generación del DE. Ver detalle en tabla data.usuario.
factura	No	Conjunto de información relacionada a la Factura Electrónica. Solo es necesario cuando el tipoDocumento=1 (Factura Electrónica) Ver detalle en tabla data.factura.
autoFactura	No	Conjunto de información relacionada a la Autofactura Electrónica Solo es necesario cuando el tipoDocumento=4 (Autofactura Electrónica Ver detalle en tabla data.autoFactura.
notaCreditoDebito	No	Conjunto de información relacionada a la Nota de Credito o Debito. Solo es necesario cuando el tipoDocumento=5 o tipoDocumento=6 (Nota de Credito/Nota de Debito) Ver detalle en tabla data.notaCreditoDebito.
remision	No	Conjunto de información relacionada a la Remisión. Solo es necesario cuando el tipoDocumento=7 (Nota de Remisión) Ver detalle en tabla data.remision.
items	Si	Conjunto de información relacionada a los items del Documento electrónico. Ver detalle en tabla data.items.
condicion	No	Conjunto de información relacionada a la condición de Pago por el Documento electrónico. Ver detalle en tabla data.condicion.
complementarios	No	Conjunto de información relacionada a los datos complementarios del Documento electrónico. Ver detalle en tabla data.complementarios.
transporte	No	Conjunto de información relacionada a los datos datos de transporte del Documento electrónico. Ver detalle en tabla data.transporte.
documentoAsociado	No	Conjunto de información relacionada a los datos documentos asociados del Documento electrónico. Ver detalle en tabla data.documentoAsociado.
descuentoGlobal	No	Descuento global de la Operación Campo XML: Relacionado a EA004
anticipoGlobal	No	Anticipo global de la Operación Campo XML: Relacionado a EA007
dncp	No	Campos de informaciones de Compras Públicas. Obligatorio si tipoOperacion=3 Ver detalle en tabla data.dncp
extras	No	Objeto de datos extras del Documento Electronico en formato key=value que puede ser enviado de forma adicional para cualquier necesidad del emisor. El mismo puede ser utilizado para mostrar en el KUDE o para fines de integracion ya que envia en el Webhook. Ej.: “extras” : {   “pedidoCliente” : “2123-1”,   “numeroPresupuesto”: “P/001”,   “posTicketId” : 39271 } Solo se acepta un nivel de JSON y en formato clave valor (no enviar el valor como otro sub JSON) Keys reservadas para uso del FS: “currentCopy” y “exportacion”.
format	No	Indica la configuración del formato de impresión (Factura, Ticket o Personalizado) con el cual se guardará el Documento Electrónico, y el cual será su valor por defecto. Si no se pasa éste atributo, se asumirá el configurado en el establecimiento a travez de la consola. Al enviar un DE por correo o imprimir un ticket se utilizará ésta opción guardada. También podrá, posteriormente, indicar explicitamente el formato que desea al momento de obtener el PDF del KUDE Posibles Valores: ticket=Especifica que el KUDE del DE quedará guardado en modo Ticket custom=Especifica que el KUDE del DE quedará guardado con el formato personalizado. (Sólo vàlido para tipoDocumento=1) Para emitir en formato normal ignore ésta opción

Parámetro	Requerido	Descripción
contribuyente	Si	Si el receptor(Cliente) del DE es contribuyente Valores: true o false Campo XML: D201
ruc	No	R.U.C. del Cliente, Obligarorio si es contribuyente. Campo XML: D206
razonSocial	Si	Nombre o Razon social del cliente,En caso de DE innominado,completar con “Sin Nombre” Campo XML: D211
nombreFantasia	No	Nombre de fantasia del cliente Campo XML: D212
tipoOperacion	Si	Tipo de operación(1= B2B, 2= B2C, 3= B2G, 4= B2F) Se debe enviar 3=B2G solo si tiene datos de licitacion de la DNCP, caso contrario enviar como 1=B2B* Campo XML:* D202
direccion	No	Direccion del Cliente, Campo obligatorio cuando tipoDocumento =7 o tipoOperacion=4 Campo XML: D213
numeroCasa	No	Numero de Casa del Cliente, Campo obligatorio si se informa la direccion,Cuando es contribuyente debe corresponder a lo declarado en el RUC Campo XML: D218
departamento	No	Código del departamento,Campo obligatorio si se informa la dirección y tipoOperacion ≠ 4, no se debe informar cuando tipoOperacion = 4. Campo XML: D219
distrito	No	Código del distrito del Cliente, El código debe seguir la Tabla 2.1 – Distritos del Manual Tecnico. Campo XML: D221
ciudad	No	Código de la ciudad del Cliente. Campo obligatorio si se informa la dirección y tipoOperacion≠4, no se debe informar cuando tipoOperacion = 4. Campo XML:D223
pais	Si	Código del Pais del Cliente, Segun XSD de Codificación de Países Campo XML:D203
tipoContribuyente	No	Tipo de contribuyente Ej.: 1= Persona Física, 2= Persona Jurídica Obligatorio si contribuyente = true, No informar si contribuyente = false Campo XML:D205
documentoTipo	No	Tipo de documento del cliente, de acuerdo a 1=Cédula paraguaya 2=Pasaporte 3=Cédula extranjera 4=Carnet de residencia 5=Innominado 6=Tarjeta Diplomática de exoneración fiscal 9=Informar data.cliente.documentoTipoDescripcion Campo XML:D208
documentoNumero	No	Número de documento de identidad.Obligatorio si contribuyente = false y tipoOperacion ≠ 4. En caso de DE innominado, completar con 0 (cero) Campo XML:D210
telefono	No	Número de teléfono. Debe incluir el prefijo de la ciudad si pais = PRY Campo XML:D214
celular	No	Numero de celular del cliente Campo XML:D215
email	No	Correo electronico del cliente Si se le pasa más de un correo (separado por comas) en eKuatia se incluirá sólo el primero Campo XML:D216
codigo	Si	Código del Cliente. Obligatorio para FacturaSend Campo XML:D217

Consideraciones especiales en objeto data.cliente.tipoOperacion
#

Si el Cliente es un contribuyente (data.cliente.contribuyente = true), entonces:
a) si el tipo de cliente es Persona Física (data.cliente.tipoContribuyente = 1), entonces éste campo puede enviarse con el valor 1-B2B (Business to Business), o;
b) si el tipo de cliente es Persona Jurídica (data.cliente.tipoContribuyente = 2), entonces éste campo puede enviarse con el valor 2-B2C (Business to Consumer), o;
c) si el RUC pertenece a un proveedor del estado, entonces éste valor debe enviarse como 3-B2G (Business to Goverment).
Si el Cliente NO es contribuyente (data.cliente.contribuyente = false), entonces:
a) Si el tipo de documento es Cédula de Identidad, Pasaporte, Carnet de residencia, Innominado, Tarjeta Diplomática de exoneración fiscal u otro (data.cliente.documentoTipo = 1,2,4,5,6 o 9), entonces éste campo puede enviarse con el valor 2-B2C (Business to Consumer), o;
b) Si el tipo de documento es Cédula Extranjera (data.cliente.documentoTipo = 3), entonces éste campo puede enviarse con el valor 4-B2F (Business to Foreign).

Objeto data.usuario #

Objeto data.obligaciones #

Objeto data.dncp #

Los campos son requeridos cuando el tipo de operacion (data.tipoOperacion) = 3-B2G.
En caso de no tener licitación regulada por la DNCP, podrán informar con ceros (0) o en su defecto uno (1), los campos de informaciones públicas a fin de que el documento pueda superar las validaciones.

Objeto data.factura #

Objeto data.autoFactura #

Objeto data.autoFactura.ubicacion #

Objeto data.notaCreditoDebito #

Objeto data.remision #

Objeto data.items #

Objeto data.items.dncp #

Objeto data.items.sectorAutomotor #

Objeto data.condicion #

Objeto data.condicion.entregas #

Objeto data.condicion.entregas.infoTarjeta #

Objeto data.condicion.entregas.infoCheque #

Objeto data.condicion.credito #

Objeto data.condicion.credito.infoCuotas #

Objeto data.sectorEnergiaElectrica #

Objeto data.sectorSeguros #

Objeto data.sectorSupermercados #

Objeto data.sectorAdicional #

Objeto data.transporte #

Objeto data.transporte.salida #

Objeto data.transporte.entrega #

Objeto data.transporte.vehiculo #

Objeto data.transporte.transportista #

Objeto data.transporte.transportista.chofer #

Objeto data.transporte.transportista.agente #

Objeto data.complementarios #

Objeto data.complementarios.carga #

Objeto data.documentoAsociado #

Objeto ({}) o Array de objetos [{}] que relacionan los documentos asociados al DE.