Tabla de contenidos
Introducción #
Para que SQLSync realice correctamente su trabajo, se requieren de 3 estructuras de tablas específicas
- Tabla/Vista principal: Esta tabla/vista contiene los registros para facturación, nota de crédito, autofactura, nota de remisión, etc. incluyendo los datos de la cabecera y los detalles (productos o servicios)
- Tabla/Vista Formas de cobros: Esta tabla/vista contiene las formas de cobro relacionados con la estructura principal, sean éstos al contado o en efectivo, cheques o transferencias que son realizados por cada movimiento.
- Tabla de resultados: corresponde a la tabla donde el SQLSync va almacenar los resultados de la integración
A continuación se estarán viendo más en detalles cada una de estas estructuras.
Tabla/Vista principal #
Nombre Tabla/Vista: transacciones_fe_view (sugerido)
Esta vista contiene todos los datos del emisor, receptor, datos de la factura e items. Los ítems se pueden repetir para un mismo transaccion_id (tra_id) y tipo_documento (tip_doc).
Los nombres de campos cortos son exclusivos para tablas DBF. (La opción DBF está DEPRECADA, sugerimos cambiarse a PostgresSQL o MySQL.)
| Nº | Campo largo Campo corto | Tipo Dato | Obligatorio | Observación | |
|---|---|---|---|---|---|
| Datos Generales | |||||
| 1 | transaccion_id tra_id | Numérico(11) | SI | Id de la Transacción (venta, nota de crédito, débito ,etc.) Identifica a la transacción, se repetirá si por ejemplo una venta tiene más de un ítem vendido | |
| 2 | clasific | String | SI | Clasificación interna de las transacciones, para identificación en el momento de actualización de datos. Por ej. a veces puede tener un tipo de documento = 1 que desee actualizar en diferentes tablas por ej. Tabla “ventas” y Tabla “orden_servicios” entonces puede usar esos nombres para la clasificación. Si no tiene distribuido las transacciones de un mismo tipo de documento en varias tablas, puede asignar NULL o cualquier valor por defecto. | |
| 3 | cdc | String(44) | No | Código CDC de 44 dígitos que desea utilizarse para el DE. Se utiliza en el caso de que desea re-enviarse un documento, por ejemplo rechazado, con un mismo CDC generado anteriormente. Su valor por defecto debe ser null. | |
| 4 | tipo_documento tip_doc | Numérico(1) | SI | Uno de los 5 tipos de documentos admitidos por eKuatia 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. | |
| 5 | establecimiento estable | Numérico(3) | SI | Representa al código de establecimiento del emisor Igualmente se puede mandar un string, siempre y cuando se haga referencia a un número Ej.: 1 | |
| 6 | punto | Numérico(3) | SI | Es el punto de emisión del documento electrónico Igualmente se puede mandar un string, siempre y cuando se haga referencia a un número Ej.: 1 | |
| 7 | numero | Numérico(7) | 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 dígitos. Ej.: 1 o ‘0000001’ | |
| 8 | serie | String(2) | SI | Número de Serie de la numeración de la Factura AA,A B, AC, etc No es obligatorio la primera vez, hasta completar toda la numeración de 7 dígitos. Si aun no usa numero de serie debe asignar el valor NULL Cuando toda la numeración de la Factura se llena, ej. 001-001-9999999, entonces se debe empezar con la serie AA, por ej.: 001-001-0000001-AA | |
| 9 | descripcion descrip | String(1-3000) | NO | Información de interés del Fisco respecto al DE. Para el caso del recibo, éste campo es utilizado para el concepto del recibo Descripción acerca del Documento electrónico. Obligatorio solo cuando el tipo de documento = 7 o cuando se realice Factura de Exportación | |
| 10 | observacion observa | String(1-3000) | NO | Información de interés del emisor respecto al DE. Cualquier información que desee aparezca en el PDF de la Factura, por ejemplo promociones, marketing, publicidad. | |
| 11 | fecha | DateTime o String(19) | SI | Fecha y hora de emisión del DE. en formato Date o en formato String Tipo Date o String en el formato “yyyy-MM-dd’T’HH:mm:ss” Ejemplo: 2022-11-06T15:48:25 es 6 de nov de 2022 | |
| 12 | tipo_emision tip_emi | Numérico(1) | SI | Tipo de emisión del DE (1 o 2) 1=Normal (Por defecto). 2=Contingencia. Mandar siempre 1 | |
| 13 | tipo_transaccion tip_tra | Numérico(2) | NO | Tipo de Transacción Obligatorio si tipo_documento = 1 o 4 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). | |
| 14 | tipo_impuesto tip_imp | Numérico(1) | SI | Tipo de impuesto afectado 1=IVA. 2=ISC. 3=Renta. 4=Ninguno. 5=IVA – Renta. | |
| 15 | moneda | String(3) | 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” | |
| 16 | anticipo | String(1) | NO | Condición del Anticipo. 1=Anticipo Global. 2=Anticipo por ítem. Ver todo sobre anticipo | |
| 17 | descuento_global des_glo | Numérico (15,8) | NO | Valor del Descuento Global a aplicar sobre la Factura Ej. 350000, 75.85, etc. | |
| 18 | anticipo_global ant_glo | Numérico (15,8) | NO | Valor del Anticipo Global a aplicar sobre la Factura Ej. 350000, 75.85, etc. | |
| 19 | tipo_cambio tip_cam | String(1) | NO | Condición del tipo de cambio. 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 | |
| 20 | cambio | Numérico(15,8) | 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. Obligatorio si moneda ≠ PYG,Si la moneda es PYG no enviar éste campo o enviar null | |
| 21 | format format | String(10) | NO | Indique si desea cambiar el formato del KUDE en el cual se guardará el Documento. Esta opción sobrescribe a la opción especificada en el establecimiento ticket=Especifica que el KUDE del DE saldrá en modo Ticket custom=Especifica que el KUDE del DE saldrá en modo personalizado. A4=Especifica que el KUDE del DE saldrá en modo A4 | |
| 22 | evento | String(20) | NO | Descripción que se utiliza para ejecutar las acciones de eventos sobre un CDC. Para crear un documento electrónico este campo debe contener NULL Para Cancelar especifique “Cancelar” junto con el evento_motivo Solo se va invocar al evento cancelar si el registro contiene un CDC y el DTE está en estado Aprobado. Para inutilizar especifique “Inutilizar” Para inutilizar debe especificar también el tipo_documento, establecimiento, punto, numero, serie(opcional), evento_motivo (desde version 1.1.279) Para Nominar especifique “Nominar” junto con el evento_motivo Solo se va invocar al evento nominacion si el registro contiene un CDC, el estado Aprobado y fue hecho a un cliente innominado. | |
| 23 | evento_motivo eve_mot | String(255) | NO | El motivo del evento a ser realizado. Obligatorio especificar un texto válido si se especifica el evento Caso contrario puede especificar NULL | |
| Datos del Cliente (Obligatorio) | |||||
| 24 | cliente_contribuyente c_contribu | Booleano | SI | Si el receptor(Cliente) del DE es contribuyente Indica si el Receptor del Documento Electrónico es o no un contribuyente de la SET. | |
| 25 | cliente_ruc c_ruc | String(5 a 10) | NO | R.U.C. del Cliente con el dígito verificador Obligatorio si contribuyente=true Ej. 80034721-1 | |
| 26 | cliente_razon_social c_raz_soc | String(4 a 255) | SI | Nombre o Razon social del cliente En caso de DE innominado, completar con “Sin Nombre” | |
| 27 | cliente_nombre_fantasia c_nom_fan | String(4-255) | NO | Nombre de Fantasía del Receptor. | |
| 28 | cliente_tipo_operacion c_tip_ope | Numérico(1) | SI | Tipo de operación 1= B2B – Cuando el receptor es un contribuyente con RUC 2= B2C – Cuando el receptor es un Cliente final con Cédula Paraguaya 3= B2G – Cuando es para el estado a través de la DNCP 4= B2F – Cuando es un receptor con documento extranjero | |
| 29 | cliente_direccion c_direcc | String(1-255) | NO | Direccion del Cliente Campo obligatorio cuando tipoDocumento = 7 o tipoOperacion = 4 | |
| 30 | cliente_numero_casa c_num_cas | String(1-6) | NO | Numero de Casa del Cliente Campo obligatorio si se informa la dirección. Cuando es contribuyente debe corresponder a lo declarado en el RUC | |
| 31 | cliente_departamento c_depart | Numérico(2) | NO | Código del departamento Campo obligatorio si se informa la dirección y tipoOperacion ≠ 4, no se debe informar cuando tipoOperacion = 4. Si no se le pasa se usa el que está relacionado con la Ciudad. | |
| 32 | cliente_distrito c_distri | Numérico(4) | NO | Codigo del distrito del Cliente El código debe seguir la Tabla 2.1 – Distritos del Manual Tecnico. Si no se le pasa se usará el que está relacionado con la Ciudad. | |
| 33 | cliente_ciudad c_ciudad | Numérico(4) | NO | Codigo de la ciudad del Cliente Campo obligatorio si se informa la dirección y tipoOperacion≠4, no se debe informar cuando tipoOperacion = 4. | |
| 34 | cliente_pais c_pais | String(3) | SI | Codigo del Pais del Cliente Segun XSD de Codificación de Países | |
| 35 | cliente_tipo_contribuyente c_tip_con | Numérico(1) | NO | Tipo de Contribuyente Ej.: 1= Persona Física, 2= Persona Jurídica Obligatorio si contribuyente = true, No informar si contribuyente = false | |
| 36 | cliente_documento_tipo c_doc_tip | Numérico(1) | NO | Tipo de documento del cliente Obligatorio si contribuyente = false y tipoOperacion ≠ 4 No informar si contribuyente = true o tipoOperacion=4 1= Cédula paraguaya 2= Pasaporte 3= Cédula extranjera 4= Carnet de residencia 5= Innominado 6=Tarjeta Diplomática deexoneración fiscal 9= Otro | |
| cliente_documento_tipo_ds c_dtip_d | String(20) | NO | Tipo de documento del cliente descripción Obligatorio si cliente_documento_tipo es enviado y si su valor = 9 Caso contrario no es tenido en cuenta | ||
| 37 | cliente_documento_numero c_doc_num | String(1-20) | NO | Número de documento de identidad Obligatorio si contribuyente = false y tipoOperacion ≠ 4. En caso de DE innominado, completar con 0 (cero) | |
| 38 | cliente_telefono c_tel | String(6-15) | NO | Número de teléfono. Debe incluir el prefijo de la ciudad si pais = PRY | |
| 39 | cliente_celular c_cel | String(10-20) | NO | Numero de celular del cliente | |
| 40 | cliente_email c_ema | String(3-80) | 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 | |
| 41 | cliente_codigo c_cod | String(3-15) | SI | Codigo del Cliente Obligatorio para FacturaSend. | |
| Datos del Usuario de la Operación (No Obligatorio) El conjunto de datos no es obligatorio, pero si envía uno de ellos debe prestar atención a la obligatoriedad de cada uno | |||||
| 42 | usuario_documento_tipo u_doc_tip | Numérico(1) | SI | Tipo de documento de identidad del responsable de la generación del DE 1= Cédula paraguaya 2= Pasaporte 3= Cédula extranjera 4= Carnet de residencia 9= Otro | |
| 43 | usuario_documento_tipo_ds u_dtip_ds | String(9-41) | No | Descripción del Tipo de documento de identidad del responsable de la generación del DE cuando el usuario_documento_tipo = 9 Obligatorio especificar la descripción cuando usuario_documento_tipo = 9, caso contrario este campo no es utilizado | |
| 44 | usuario_documento_numero u_doc_num | String(1-20) | SI | Número de documento de identidad del responsable de la generación del DE Depende del campo usuario_documento_tipo. | |
| 45 | usuario_nombre u_nom | String(4-255) | SI | Nombre o razón social del responsable de la generación del DE | |
| 46 | usuario_cargo u_car | String(4-100) | SI | Cargo del responsable de la generación del DE | |
| 47 | extras | String | No | Cadena de caracteres en formato JSON con datos extras del documento electrónico o datos para la Factura de Exportación Ej. ‘{“tender_amount”: 1500000, “vuelto” : 300000}’ | |
| config | String | No | Cadena de caracteres en formato JSON con datos de configuracion adicional del documento o formatos. Para más información CONFIG Ejemplo: { “pygDecimals” : 3, “pygTaxDecimals” : 3, “decimals” : 3, “taxDecimals” : 3, “kudeParam.quantityDecimals” : 3, “kudeParam.pygDecimals” : 3, “kudeParam.pygTaxDecimals” : 3, “kudeParam.decimals” : 3, “kudeParam.taxDecimals” : 3 } | ||
| Datos de la Factura Electrónica (Obligatorio para tipo_documento = 1) | |||||
| 48 | factura_presencia fa_pre | Numérico(1) | SI | Indicador de presencia 1= Operación presencial 2= Operación electrónica 3= Operación telemarketing 4= Venta a domicilio 5= Operación bancaria 6= Operación cíclica 9= Otro | |
| 49 | factura_presencia_ds fa_pre_ds | String(10-30) | No | Indicador de presencia cuando factura_presencia = 9 Obligatorio cuando factura_presencia = 9. Caso contrario este campo no será enviado | |
| 50 | factura_fecha_envio fa_fec_env | String(10) | NO | Fecha de envío de la mercadería en el formato yyyy-MM-dd. Debe ser después de la Fecha de la Factura En caso de no utilizar esos campos pueden conterner | |
| Datos de la Factura Electrónica DNCP (Compras públicas, no obligatorio) | |||||
| 51 | factura_dncp_modalidad f_dncp_m | String(2) | SI | Modalidad – Código emitido por la DNCP | |
| 52 | factura_dncp_entidad f_dncp_e | Numérico(5) | SI | Entidad – Código emitido por la DNCP | |
| 53 | factura_dncp_anho f_dncp_ano | Numérico(2) | SI | Año – Código emitido por la DNCP | |
| 54 | factura_dncp_secuencia f_dncp_s | Numérico(7) | SI | Secuencia – emitido por la DNCP | |
| 55 | factura_dncp_fecha f_dncp_f | String(10) | SI | Fecha de emisión del código de contratación por la DNCP | |
| Datos de Autofactura (Obligatorio para tipo_documento = 4) | |||||
| 56 | autofactura_tipo_vendedor af_tip_ven | Numérico(1) | SI | Naturaleza del vendedor1= No contribuyente2= Extranjero | |
| 57 | autofactura_documento_tipo af_doc_tip | Numérico(1) | SI | Tipo de documento de identidad del vendedor | |
| 58 | autofactura_documento_numero af_doc_num | String(9 a 20) | SI | Número de documento de identidad del vendedor | |
| 59 | autofactura_nombre af_nombre | String(4 a 60) | SI | Nombre y apellido del vendedor | |
| 60 | autofactura_direccion af_direcc | String(255) | SI | Dirección del vendedor. En caso de extranjeros, colocar la dirección en donde se realizó la transacción. | |
| 61 | autofactura_numero_casa af_num_cas | string(6) | SI | Número de casa del vendedor.Si no tiene numeración colocar 0 (cero) | |
| 62 | autofactura_departamento af_depart | Numérico(2) | SI | Código del departamento del vendedor | |
| 63 | autofactura_distrito af_distri | Numérico(4) | SI | Código del distrito del vendedor | |
| 64 | autofactura_ciudad af_ciudad | Numérico(5) | SI | Código de la ciudad del vendedor | |
| 65 | autofactura_ubicacion_lugar af_ubi_lug | String(255) | SI | Lugar de la transacción | |
| 66 | autofactura_ubicacion_departamento af_ubi_dep | Numérico(2) | SI | Código del departamento donde se realiza la transacción | |
| 67 | autofactura_ubicacion_distrito af_ubi_dis | Numérico(4) | SI | Código del distrito donde se realiza la transacción | |
| 68 | autofactura_ubicacion_ciudad af_ubi_ciu | Numérico(5) | SI | Código de la ciudad donde se realiza la transacción | |
| Datos de la Nota de Crédito o Débito (Obligatorio para tipo_documento = 5 o 6) | |||||
| 69 | nota_credito_motivo nc_motivo | Numérico(1) | SI | Motivo de la emisión 1= Devolución y Ajuste de precios 2= Devolución 3= Descuento 4= Bonificación 5= Crédito incobrable 6= Recupero de costo 7= Recupero de gasto 8= Ajuste de precio | |
| Datos de la Nota de Remisión (Obligatorio para tipo_documento = 7) | |||||
| 70 | nota_remision_motivo nr_motivo | Numérico(2) | SI | Motivo de la remisión 1= Traslado por venta 2= Traslado por consignación 3= Exportación 4= Traslado por compra 5= Importación 6= Traslado por devolución 7= Traslado entre locales de la empresa 8= Traslado de bienes por transformación 9= Traslado de bienes por reparación 10= Traslado por emisor móvil 11= Exhibición o demostración 12= Participación en ferias 13= Traslado de encomienda 14= Decomiso 99= Otro | |
| nota_remision_motivo_ds nr_mot_ds | String (5-60) | No | Descripción del motivo de la remisión Obligatorio si cuando nota_remision_motivo = 99 de lo contrario este campo no es utilizado | ||
| 71 | nota_remision_tipo_responsable nr_tip_res | Numérico(1) | SI | Tipo de Responsable de la Remisión 1= Emisor de la factura 2= Poseedor de la factura y bienes 3= Empresa transportista 4= Despachante de Aduanas 5= Agente de transporte o intermediario | |
| 72 | nota_remision_kms nr_kms | Numérico(5) | SI | Kilómetros estimados de recorrido | |
| 73 | nota_remision_fecha_factura nr_fec_fac | String(10) | SI | Fecha futura de emisión de la factura (AAAA-MM-DD) | |
| 74 | nota_remision_costo_flete nr_cos_fle | Numérico(15,8) | SI | Costo del Flete | |
| 75 | total | Numérico | SI | Monto total de la Transacción. Este es un campo que se utiliza para mostrar en el monitor, no se envía a la SET como tal. | |
| 76 | estado | Numérico (2) | NO | Estado de una transacción ya integrada NULL o -1,-3. -2 0,1,2,3,4,98,99 NULL = Sin integrar(valor p/ defecto) -1 = Sin integrar, -3 = En proceso de Consultar Estado, -2 = En proceso de integración, 0 = Generado, 1 = Enviado, 2 = Aprobado, 3 = Aprobado con Obs, 4 = Rechazado, 98 = Inexistente, 99 = Cancelado * De donde tomar este dato?: Ver Actualización de Datos | |
| 77 | error | String(254) | NO | Mensaje de Error de una venta que no se ha podido integrar * De donde tomar este dato?: Ver Actualización de Datos | |
| 78 | pausado | Numérico (1) | NO | Indica si este registro está pausado y no debe enviarse en la integración de un nuevo documento electrónico, como así también en la integración de los eventos. Pausado = 1 No Pausado = NULL | 0 * De donde tomar este dato?: Ver Actualización de Datos | |
| 79 | error_evento err_eve | String(254) | NO | Mensaje de error del evento ejecutado * De donde tomar este dato?: Ver Actualización de Datos | |
| 80 | estado_evento es_eve | Numérico (1) | NO | Estado de evento ejecutado2=Evento Aprobado4=Evento Rechazado (Error se guarda en error_evento) * De donde tomar este dato?: Ver Actualización de Datos Su valor por defecto debe ser null. | |
| 81 | obligaciones obligacion | String(5 a 10) | NO | Códigos de las Obligaciones que afecta al documento electrónico según Nota Técnica 18 Código o Códigos de las obligaciones separados por comas, por ejemplo, “113, 143” | |
| Ítems de la Operación (Se repite tantas veces como ítems se posean) | |||||
| 100 | item_codigo i_codigo | String(20) | SI | Código del Producto | |
| 101 | item_descripcion i_descrip | String(120) | SI | Descripción del Producto Equivalente a nombre del producto establecido en la RG 24/2019 | |
| 102 | item_observacion i_observ | String(500) | NO | Informacion de interes acerca del ítem | |
| 103 | item_partida_arancelaria i_par_ara | Numérico(4) | NO | Partida Arancelaria | |
| 104 | item_ncm i_ncm | String(6 a 8) | NO | Nomenclatura Común del Mercosur del producto | |
| 105 | item_unidad_medida i_uni_med | Numérico(5) | SI | Unidad de Medida del Producto 87 = Metros 2366 = Costo por Mil 2329 = Unidad Internacional 110 = Metros cúbicos 77 = Unidad 86 = Gramos 89 = Litros 90 = Miligramos 91 = Centimetros 92 = Centimetros cuadrados 93 = Centimetros cubicos 94 = Pulgadas 96 = Milímetros cuadrados 79 = Kilogramos s/ metro cuadrado 97 = Año 98 = Mes 99 = Tonelada 100 = Hora 101 = Minuto 104 = Determinación 103 = Yardas 108 = Metros 109 = Metros cuadrados 95 = Milímetros 666 = Segundo 102 = Día 83 = Kilogramos 88 = Mililitros | |
| 106 | item_cantidad i_cantidad | Numérico (10,4) | SI | Cantidad del Producto Vendido o servicio | |
| 107 | item_precio_unitario i_pre_uni | Numérico (15,8) | SI | Precio Unitario del Producto Vendido | |
| 108 | item_cambio i_cambio | Numérico (5,4) | NO | Cotización o cambio de moneda sobre el precio del producto | |
| 109 | item_descuento i_descue | Numérico (15,8) | NO | Descuento del producto sobre el precio unitario del item Ej. 77500, 15.17, etc. | |
| 110 | item_anticipo i_anti | Numérico (15,8) | NO | Valor del anticipo sobre el precio unitario del item | |
| 111 | item_pais i_pais | String(3) | NO | País de origen del producto Segun XSD de Codificacion de Paises | |
| 112 | item_tolerancia i_tol | String(1) | NO | Código de datos de relevancia de los productos 1=Tolerancia de quiebra 2= Tolerancia de merma | |
| 113 | item_tolerancia_cantidad i_tol_can | Numérico(10,4) | NO | Cantidad de quiebra o merma | |
| 114 | item_tolerancia_porcentaje i_tol_por | Numérico(3,8) | NO | Porcentaje de quiebra o merma | |
| 115 | item_cdc_anticipo i_cdc_ant | String(44) | NO | Código de Control de la Factura Relacionada de anticipo | |
| 116 | item_iva_tipo i_iva_tip | Numérico(1) | SI | Forma de afectación tributaria del IVA 1= Gravado IVA 2= Exonerado (Art. 83- Ley 125/91) 3= Exento 4= Gravado parcial Grav-Exento) | |
| 117 | item_iva_base i_iva_bas | Numérico (3) | SI | Base gravada del IVA por ítem | |
| 118 | item_iva i_iva | Numérico(2) | SI | Tasa del IVA Posibles valores = 0, 5 o 10 | |
| 119 | item_lote i_lote | String(80) | NO | Número de Lote del producto Longitud: [1-80] | |
| 120 | item_vencimiento i_venci | String(10) | NO | Fecha de vencimiento del producto Formato AAAA-MM-DD | |
| 121 | item_numero_serie i_num_ser | String(10) | NO | Número de serie | |
| 122 | item_numero_pedido i_num_ped | String(20) | NO | Número de pedido | |
| 123 | item_numero_seguimiento i_num_seg | String(20) | NO | Número de seguimiento del envío | |
| 124 | item_registro_senave i_reg_sen | String(20) | NO | Número de registro del producto otorgado por el SENAVE Obligados por la RG N° 16/2019 y la RG N° 24/2019 – Agroquímicos | |
| 125 | item_registro_entidad_comercial i_reg_ent | String(20) | NO | Número de registro de entidad comercial otorgado por el SENAVE | |
| 126 | item_extras i_extras | String | No | Cadena de caracteres en formato JSON con datos extras para este ítem del documento electronico Ej. ‘{“codigo_barras”: “234098742734987034”}’ | |
| Datos del Documento Asociado. Obligatorio para tipo de documento 4 y opcional para tipo de documento 7 | |||||
| 150 | doc_aso_formato d_aso_for | Numérico(1) | SI | Tipo de documento Asociado 1= Electronico 2= Impreso 3= Constancia Electronica Obs: si el tipo_documento = 4-Autofacura, el tipo de documento asociado debe ser 3-Constancia Electronica. | |
| 151 | doc_aso_cdc d_aso_cdc | String (44) | No | CDC del DTE referenciado Obligatorio si doc_aso_formato = 1 | |
| 152 | doc_aso_tipo_documento_impreso d_aso_tdi | Numérico (1) | SI | Tipo de documento Impreso Obligatorio si doc_aso_formato = 2 1= factura 2= nota de credito 3= nota de debito 4= nota de remision 5= comprobante de retencion | |
| 153 | doc_aso_timbrado d_aso_tim | Numérico (8) | NO | Número del timbrado del documento impreso de referencia Obligatorio si doc_aso_formato = 2 | |
| 154 | doc_aso_establecimiento d_aso_est | String (3) | NO | Establecimiento Obligatorio si doc_aso_formato = 2 Completar con 0 a la izquierda | |
| 155 | doc_aso_punto d_aso_pun | String (3) | NO | Punto de Expedición Obligatorio si doc_aso_formato = 2 Completar con 0 a la izquierda | |
| 156 | doc_aso_numero d_aso_num | String(7) | NO | Número del documento Obligatorio si doc_aso_formato = 2 Completar con 0 a la izquierda | |
| 157 | doc_aso_fecha d_aso_fec | String(10) | NO | Fecha de emisión del documento impreso de referencia, en formato yyyy-MM-dd Obligatorio si existe el campo doc_aso_timbrado | |
| 158 | doc_aso_numero_retencion d_aso_ret | String (15) | NO | Número de comprobante de retención | |
| 159 | doc_aso_reso_credito_fiscal d_aso_rcf | String (15) | NO | Numero de resolucion de credito fiscal | |
| 160 | doc_aso_constancia_tipo d_aso_cti | Numérico (1) | NO | Tipo de constancia Obligatorio si doc_aso_formato = 3 1= Constancia de no ser contribuyente 2= constancia de microproductores | |
| 161 | doc_aso_constancia_numero d_aso_cnu | Numérico (11) | NO | Número de Constancia Obligatorio si doc_aso_formato = 2 y doc_aso_constancia_tipo= 2 | |
| 162 | doc_aso_constancia_control d_aso_cco | String (8) | NO | Número de control de constancia Obligatorio si doc_aso_formato = 2 y doc_aso_constancia_tipo= 2 | |
| 163 | doc_aso_ruc_fusionado d_aso_rfu | String (3 a 8) | NO | RUC fusionado del CDC Si el CDC del Documento referenciado pertenece a un RUC fusionado, indicar aqui, sin el DV Disponible desde la nota tecnica 23 | |
| 164 | doc_aso_monto d_aso_mont | Numérico(15,8) | NO | Monto del documento asociado, utilizado para el caso de recibos digitales | |
| Datos del Transporte. Obligatorio sólo para Tipo de Documento 1 o 7 (Obligatorio para Tipo 7) | |||||
| 200 | tra_tipo t_tip | Numérico(1) | NO | Tipo de transporte Tipo de transporte. Obligatorio si tipoDocumento = 7. 1= Propio 2= Tercero | |
| 201 | tra_modalidad t_mod | Numérico(1) | Si | Modalidad del transporte 1=Terrestre 2= Fluvial 3= Aéreo 4= Multimodal | |
| 202 | tra_tipo_responsable t_tip_res | Numérico(1) | Si | Responsable del costo del flete 1= Emisor de la Factura Electrónica 2= Receptor de la Factura Electrónica 3= Tercero 4= Agente intermediario del transporte (cuando intervenga) 5= Transporte propio | |
| 203 | tra_condicion_negociacion t_con_neg | String (3) | NO | Condición de la negociación CFR =Costo y flete CIF =Costo, seguro y flete CIP =Transporte y seguro pagados hasta CPT =Transporte pagado hasta DAP =Entregada en lugar convenido DAT =Entregada en terminal DDP = Entregada derechos pagados EXW =En fabrica FAS =Franco al costado del buque FCA = Franco transportista FOB =Franco a bordo | |
| 204 | tra_fecha_inicio t_f_ini | String(10) | NO | Fecha estimada de inicio de traslado Obligatorio si tipo_documento = 7 Opcional si tipo_documento = 1Fecha en el formato: AAAA-MM-DD | |
| 205 | tra_fecha_fin t_f_fin | Fecha(10 ) | NO | Fecha estimada de fin de traslado Obligatorio si existe el campo tra_fecha_inicioFecha en el formato: AAAA-MM-DD | |
| 206 | tra_sali_direccion t_sal_dir | String(255) | SI | Direccion del local de salida Nombre de la calle principal | |
| 207 | tra_sali_numero_casa t_sal_nca | String (6) | SI | Numero de casa de salida Si no tiene numeración colocar 0 | |
| 208 | tra_sali_comple_direccion1 t_sal_cd1 | String(255) | NO | Complemento de dirección 1 salida Nombre de la calle secundaria | |
| 209 | tra_sali_comple_direccion2 t_sal_cd2 | String(255) | NO | Complemento de la dirección 2 salida Numero de departamento/piso/local/edificio/deposito del local de salida de la mercaderia | |
| 210 | tra_sali_departamento t_sal_dep | Numérico (2) | SI | Código del departamento del local de salida | |
| 211 | tra_sali_distrito t_sal_dis | Numérico (4) | NO | Código del distrito del local de salida | |
| 212 | tra_sali_ciudad t_sal_ciu | Numérico(5) | SI | Código de la ciudad del local de salida | |
| 213 | tra_sali_pais t_sal_pai | String (3) | NO | Codigo del pais del local de salida | |
| 214 | tra_sali_telefono_contacto t_sal_tel | String (15) | NO | Teléfono de contacto del local de salida | |
| 215 | tra_entre_direccion t_ent_dir | String (255) | SI | Direccion del local de entrega | |
| 216 | tra_entre_numero_casa t_ent_nca | string (6) | SI | Numero de casa de entrega | |
| 217 | tra_entre_comple_direccion1 t_ent_cd1 | String (255) | NO | Complemento de dirección 1 entrega | |
| 218 | tra_entre_comple_direccion2 t_ent_cd2 | String (255) | NO | Complemento de dirección 2 entrega | |
| 219 | tra_entre_departamento t_ent_dep | Numérico (2) | SI | Código del departamento del local de la entrega | |
| 220 | tra_entre_distrito t_ent_dis | Numérico(4) | NO | Código del distrito del local de la entrega | |
| 221 | tra_entre_ciudad t_ent_ciu | Numérico (5) | SI | Código de la ciudad del local de la entrega | |
| 222 | tra_entre_pais t_ent_pai | String (3) | NO | Codigo del pais de entrega | |
| 223 | tra_entre_telefono_contacto t_ent_tel | String (15) | NO | Teléfono de contacto del local de la entrega | |
| 224 | tra_vehi_tipo t_veh_tip | String (10) | SI | Tipo de vehículo Tipo de vehículo. Ejemplo: Camioneta, Barcaza, Helicoptero, Debe ser acorde al tipo de transporte | |
| 225 | tra_vehi_marca t_veh_mar | String (10) | SI | Marca | |
| 226 | tra_vehi_documento_tipo t_veh_dti | Numérico (1) | SI | Tipo de identificacióndel vehículo 1=Número de identificación del vehículo 2=Número de matrícula del vehículo | |
| 227 | tra_vehi_documento_numero t_veh_dnu | String (6) | NO | Número de identificación del vehículo Informar si tra_vehi_documento_tipo = 2 | |
| 228 | tra_vehi_obs t_veh_obs | String (20) | NO | Datos adicionales del vehículo | |
| 229 | tra_vehi_numero_matricula t_veh_mat | String (6) | NO | Número de matrícula del vehículo Informar si tra_vehi_documento_tipo = 2 | |
| 230 | tra_vehi_numero_vuelo t_veh_vue | String (6) | NO | Número de vuelo Obligatorio si tra_modalidad = 3 | |
| 231 | tra_transpor_contribuyente t_t_con | Booleano | SI | Naturaleza del transportista V=contribuyente F=no contribuyente | |
| 232 | tra_transpor_nombre t_t_nom | String (60) | SI | Nombre o razón social del transportista Ej.: EMPRESA SA; JULIAN GOMEZ | |
| 233 | tra_transpor_ruc t_t_ruc | String (5 a 10) | NO | RUC del transportista Obligatorio si tra_transpor_contribuyente = V | |
| 234 | tra_transpor_documento_tipo t_t_dti | Numérico (1) | NO | Tipo de documento de identidad del transportista 1= Cédula paraguaya 2= Pasaporte 3= Cédula extranjera 4= Carnet de residencia | |
| 235 | tra_transpor_documento_numero t_t_dnu | String (20) | NO | Número de documento de identidad del transportista Obligatorio si existe el campo tra_transpor_documento_tipo | |
| 236 | tra_transpor_direccion t_t_dir | String (150) | NO | Domicilio Fiscal del transportista | |
| 237 | tra_transpor_obs t_t_obs | String(255) | NO | Observacion del transportista | |
| 238 | tra_transpor_pais t_t_pai | String(3) | NO | Código del país de origen del transportista | |
| 239 | tra_transpor_chofer_doc_numero t_t_c_dnu | String(20) | SI | Número de documento de identidad del chofer Ej.: 321654 | |
| 240 | tra_transpor_chofer_nombre t_t_c_nom | String (60) | SI | Nombre y apellido del chofer Ej.: JULIAN GOMEZ | |
| 241 | tra_transpor_chofer_direccion t_t_c_dir | String (255) | NO | Dirección del chofer | |
| 242 | tra_transpor_agente_nombre t_t_a_nom | String(60) | NO | Nombre o razón social del agente | |
| 243 | tra_transpor_agente_ruc t_t_a_ruc | String (5 a 10) | NO | RUC del Agente | |
| 244 | tra_transpor_agente_direccion t_t_a_dir | String (255) | NO | Direccion del agente | |
| Complementarios | |||||
| 245 | cpt_orden_compra cpt_ord_cm | String (1 a 15) | NO | Número de orden de compra | |
| 246 | cpt_orden_venta cpt_ord_vn | String (1 a 15) | NO | Número de orden de venta | |
| 247 | cpt_asiento cpt_asient | String (1 a 10) | NO | Número de asiento contable | |
| 248 | cpt_carga_unid_medida_vol_total cpt_um_vt | Numeric (1 a 5) | NO | Unidad de medida del total de volumen de la mercadería. Segun tabla de unidades de medidas | |
| 249 | cpt_carga_volumen_total cpt_vt | Numeric (1 a 20) | NO | Volumen total de la mercadería | |
| 250 | cpt_carga_unid_medida_peso_total cpt_um_pt | Numeric (1 a 5) | NO | Unidad de medida del peso total de la mercadería. Segun tabla de unidades de medidas | |
| 251 | cpt_carga_peso_total cpt_pt | Numeric (1 a 20) | NO | Peso total de la mercadería | |
| 252 | cpt_carga_caract_carga cpt_car | Numeric (1 a 20) | NO | Característica de la Carga Obligatorio cuando lo exige la RG 41/14 1 – Mercaderías con cadena de frío 2 – Carga peligrosa 3 – Otro de características similares (especificar) | |
| 253 | cpt_carga_caract_carga_descripcion cpt_car_d | String (1 a 50) | NO | Descripcion de la caracteristica de carga Solo especificar cuando caracteristicaCarga = 3 | |
| 254 | do_integra | Numeric(1) | SI | Campo para especificar si el registro está listo para integrarse. Útil para los casos donde se van completando registros y campos de forma incremental, pero aún no desea que el integrador tome esos datos. Valores: 1 = Listo para integrarse 0 = Aún no se debe integrar Tenga cuidado para setear éste campo con el mismo valor para todos los registros del mismo ID de transacción. | |
Tabla/Vista Formas de Cobro #
Nombre Vista: transacciones_fc_fe_view
| Campos | Tipo de Dato | Obligatorio | Observación |
|---|---|---|---|
| transaccion_id (FK) tra_id | Numérico(10) | SI | Campo que se relaciona con la cabecera de la vista principal Debe estar relacionado con el número de la transacción. |
| clasific | String | SI | Clasificación interna de las transacciones, para identificación en el momento de actualización de datos. Por ej. a veces puede tener un tipo de documento = 1 que desee actualizar en diferentes tablas por ej. Tabla “ventas” y Tabla “orden_servicios” entonces puede usar esos nombres para la clasificación. Si no tiene distribuido las transacciones de un mismo tipo de documento en varias tablas, puede asignar NULL o cualquier valor por defecto. |
| tipo_documento tip_doc | Numérico (1) | SI | 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. |
| tipo | Numérico (1) | SI | Condición de la operación. 1= Contado2= Crédito |
| entregas_tipo e_tipo | Numérico (2) | NO | Tipo de pago Obligatorio si tipo = Contado. 1= Efectivo 2= Cheque 3= Tarjeta de crédito 4= Tarjeta de débito 5= Transferencia 6= Giro 7= Billetera electrónica 8= Tarjeta empresarial 9= Vale 10= Retención 11= Pago por anticipo 12= Valor fiscal 13= Valor comercial 14= Compensación 15= Permuta 16= Pago bancario (Informar solosi E011=5) 17 = Pago Móvil 18 = Donación 19 = Promoción 20 = Consumo Interno 21 = Pago Electrónico 99 = Otro |
| entregas_tipo_descripcione_tipo_des | String | NO | Descripcion del Tipo de Pago Obligatorio cuando entregas_tipo = 99 Cuando se trata de una entregas_tipo 99 hay que especificar el medio personalizado de pago, caso contrario no es necesario especificar |
| entregas_monto e_monto | Numerico | NO | Monto por tipo de pago Obligatorio si tipo = Contado |
| entregas_moneda e_moneda | String | NO | Moneda por tipo de pago Obligatorio si tipo = Contado. Según tabla de códigos para monedas de acuerdo con la norma ISO 4217 Se requiere la misma moneda para todos los ítems del DE |
| entregas_cambio e_cambio | Numérico | NO | Tipo de cambio por tipo de pago Obligatorio si tipo = Contado y moneda ≠ PYG |
| entregas_info_tarjeta_tipo e_tar_tip | Numérico | NO | Código de la Denominación de la tarjeta. Solo informar si pago al contado o del monto de la entrega inicial y si el pago o entrega inicial de la operación fue total o parcialmente en tarjeta de crédito/débito. 1= Visa 2= Mastercard 3= American Express 4= Maestro 5= Panal 6= Cabal 99= Otro |
| entregas_info_tarjeta_tipo_descripcion e_tar_tipd | String | NO | Descripción de la Denominación de la tarjeta. Obligatorio cuando entregas_info_tarjeta_tipo = 99 es necesario especificar el nombre personalizado de la Tarjeta |
| entregas_info_tarjeta_numero e_tar_num | Numérico | NO | Número de la tarjeta Solo informar si pago al contado o del monto de la entrega inicial y si el pago o entrega inicial de la operación fue total o parcialmente en tarjeta de crédito/débito.Cuatro últimos dígitos de la tarjeta |
| entregas_info_tarjeta_titular e_tar_tit | String | NO | Nombre del titular de la tarjeta Solo informar si pago al contado o del monto de la entrega inicial y si el pago o entrega inicial de la operación fue total o parcialmente en tarjeta de crédito/débito. |
| entregas_info_tarjeta_ruc e_tar_ruc | String(5 a 10) | NO | RUC de la procesadora de tarjeta Solo informar si pago al contado o del monto de la entrega inicial y si el pago o entrega inicial de la operación fue total o parcialmente en tarjeta de crédito/débito. |
| entregas_info_tarjeta_razon_social e_tar_raz | String | NO | Razón social de la procesadora de tarjeta Solo informar si pago al contado o del monto de la entrega inicial y si el pago o entrega inicial de la operación fue total o parcialmente en tarjeta de crédito/débito. |
| entregas_info_tarjeta_medio_pago e_tar_mpa | Numérico | NO | Forma de procesamiento de pago. Solo informar si pago al contado o del monto de la entrega inicial y si el pago o entrega inicial de la operación fue total o parcialmente en tarjeta de crédito/débito. 1= POS2= Pago Electrónico (Ejemplo:compras por Internet) 9= Otro |
| entregas_info_tarjeta_codigo_autorizacion e_tar_cau | Numérico | NO | Código de autorización de la operación Solo informar si pago al contado o del monto de la entrega inicial y si el pago o entrega inicial de la operación fue total o parcialmente en tarjeta de crédito/débito. |
| entregas_info_cheque_numero_cheque e_che_nch | String | NO | Número de cheque Solo informar si pago al contado o del monto de la entrega inicial y si el pago o entrega inicial de la operación fue total o parcialmente en cheque. Completar con 0 (cero) a la izquierda hasta alcanzar 8 (ocho) cifras |
| entregas_info_cheque_banco e_che_ban | String | NO | Banco emisor Solo informar si pago al contado o del monto de la entrega inicial y si el pago o entrega inicial de la operación fue total o parcialmente en cheque. |
| credito_tipo c_tipo | Numérico | NO | Condición de la operación a crédito Solo informar si tipo = 2 (crédito). 1= Plazo 2= Cuota |
| credito_plazo c_plazo | String(10) | NO | Plazo del crédito Obligatorio si tipo = 1 Ejemplo: 30 días, 12 meses |
| credito_cuotas c_cuotas | Numérico | NO | Cantidad de cuotas Cantidad de Cuotas Obligatorio si credito_tipo = 2 Ejemplo: 12, 24, 36 |
| credito_info_cuotas_moneda c_cuo_mn | String(3) | NO | Moneda de las cuotas. Solo informar si credito_tipo = 2. Según tabla de códigos para monedas de acuerdo con la norma ISO 4217 |
| credito_info_cuotas_monto c_cuo_mon | Numérico | NO | Monto de cada cuota El monto de la Cuota. |
| credito_info_cuotas_vencimiento c_cuo_ven | String(10) | NO | Fecha de vencimiento de cada cuota Vencimiento de la Cuota en formato yyyy-MM-dd. Ejemplo 2023-03-25No es obligatorio |
Tabla de resultados #
Nombre Vista: facturasend_result
| Campos | Tipo de Dato | Obligatorio | Observación |
|---|---|---|---|
| transaccion_id (FK) tra_id | Numérico(10) | SI | Campo que se relaciona con la cabecera de la vista principal Debe estar relacionado con el número de la transacción. |
| clasific | String | No | Clasificación interna de las transacciones, para identificación en el momento de actualización de datos. Por ej. a veces puede tener un tipo de documento = 1 que desee actualizar en diferentes tablas por ej. Tabla “ventas” y Tabla “orden_servicios” entonces puede usar esos nombres para la clasificación Si no tiene distribuido las transacciones de un mismo tipo de documento en varias tablas, puede asignar NULL o cualquier valor por defecto. |
| tipo_documento tip_doc | Numérico (1) | SI | 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. |
| name | String | SI | Nombre del Campo Se almacenará el nombre del campo con la información que corresponde |
| value | String | NO | Valor del campo |
