Nota de Crédito
Datos requeridos para generar una Nota de Crédito
Atención
(*) = Campos Opcionales
Los tipos de Datos son referenciados luego del nombre de cada variable.
decimal(15,4) = Un Decimal de hasta 15 enteros y 4 lugares decimales
Ejemplos
operacion number(1) (significa que el tipo de datos es un NUMERICO de longitud 1)
char(1-10) = Un Texto de longitud minima 1 hasta maximo 10
Datos Basicos (Cabecera)
operacion number(1) > Tipo de la operacion al que pertenece esta estructura de datos
1= Factura electrónica 2= Factura electrónica de exportación (A Futuro) 3= Factura electrónica de importación (A Futuro) 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 8= Comprobante de retención electrónico (A Futuro)(*) cdc char(44) (todos los 44 digitos deben ser numericos) > CDC de la Nota de Crédito, si no informado o vacio, DeNet lo va a generar en base a los datos enviados. (Ver manual de SIFEN de como generar el CDC en la pagina 56) Ver Manual
fecha_documento char(10) > Fecha del Documento en formato YYYY-MM-DD
[Ejemplo: 2023-01-01]numero_timbrado number(8) > Numero del Timbrado
serie_timbrado char(2) > Serie del Timbrado (Siempre empieza por la Serie AA)
fecha_inicio_timbrado char(10) > Fecha de inicio del Timbrado en formato YYYY-MM-DD
[Ejemplo: 2023-01-01]establecimiento_timbrado char(3) Establecimiento Emisor
[Ejemplo: 001,002,003]expedicion_timbrado char(3) Expedicion Emisor
[Ejemplo: 001,002,003]numero_documento number(7) > Numero de la Nota de Crédito
[Ejemplo: 1,2,3,4,etc]moneda_operacion char(3) > Codigo Alfanumerico de la Moneda para la operacion de ventas (solo es permitido Dolares = USD o Guaranies = PYG)
[PYG , USD]
tipo_impuesto number(1) > Tipo de impuesto del documento
1= IVA 2= ISC 3= Renta 4= Ninguno 5= IVA – Rentatipo_transaccion number(1) > Tipo de operacion del documento
1= "Venta de mercadería", 2= "Prestación de servicios", 3= "Mixto", 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= "Compra de servicios", 12= "Venta de crédito fiscal", 13= "Muestras médicas (Art. 3 RG 24/2014)"codigo_pais_receptor char(3) Ver Lista de Paises mas Utilizados
condicion_operacion number(1) > Condicion de la operacion
[1 = CONTADO, 2 = CREDITO]
cotizacion_operacion decimal(10,4) > Solo requerido si moneda operacion es DOLAR(USD)
tipo_presencia_operacion number(1) > Tipo de presencia de la operacion
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íclicatipo_receptor number(1) > Tipo del receptor de la operacion
1= CONTRIBUYENTE 2= NO CONTRIBUYENTEtipo_contribuyente_receptor number(1) > Tipo de Contribuyente Receptor
1= Persona Física 2= Persona Jurídica(*) tipo_documento_receptor number(1) > Tipo del documento del receptor para el caso que no tenga RUC o sea si el tipo_receptor = 2, caso contrario se puede ignorar o informar valor 0
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= Otronombre_receptor char(4-255) > Nombre/Razon social del receptor
descripcion_tipo_documento_receptor char(9-41) > Descripcion del tipo de documento del receptor.
TIP
solo completar en el caso de que el tipo_documento_receptor sea igual a = 9 (otro)
numero_documento_receptor char(1-20) > Numero/Identificacion del Documento del Receptor (CI, Pasaporte, etc) según el tipo de documento informado > tipo_documento_receptor, solo se utiliza en caso de que el Receptor NO sea un CONTRIBUYENTE
ruc_receptor char(3-8) > RUC del Receptor CONTRIBUYENTE, solo se utiliza en caso de que el Receptor sea un CONTRIBUYENTE
(*) telefono_receptor char(6-15) > Telefono del receptor
(*) observacion char(1-3000) > Observacion de la operacion
(*) email_receptor char(3-80) > Email del receptor
(*) direccion_receptor char(1-255) > Direccion del receptor
tipo_operacion char(3) > Tipo de la operacion entre ambas partes (emisor y receptor)
B2B (Empresa para Empresa) B2C (Empresa para persona Fisica) B2G (Empresa para Gobierno) B2F (Empresa para Extranjero) (Esta última opción debe utilizarse solo en caso de servicios para empresas o personas físicas del exterior)descuento_global decimal(10,8) > Descuento Global Expresado en VALOR para el total de la operacion
[Ejemplo: 10000]redondeo_sedeco decimal(3,4) > Redondeo SEDECO de la operacion
total_operacion decimal(20,5) > Total General de la operacion (este total deberia ser lo que el clinete final pago)
registro_sistema char(1-50) > Registro/Identificador/Secuencia/Primarykey al que pertenece la Nota de Credito en el Sistema de Facturacion que se integra a DeNet
id_sucursal number(10) > Identificador de SUCURSAL-ESTABLECIMIENTO EMISOR proveido por DeNetPy al momento que se configura cada Local Emisor de Nota de Credito.
Datos de Items (Items-Productos-Servicios)
sub grupo de datos se debe llamar items_operacion (array)
Los Items de la operaccion (items_operacion) es un Array (o sea puede repetirse tanto cuanto sea necesario)
- codigo_interno_sistema char(1-20) > Codigo interno dentro del sistema ERP u otro sistema que identifica al Producto-Item-Servicio.
- descripcion char(1-120) > Descripcion del item
- afecta_iva number(1) > Tipo del IVA al que pertenece este item
1= "Gravado IVA" 2= "Exonerado (Art. 83- Ley 125/91)" 3= "Exento" 4= "Gravado parcial (Grav-Exento)" - proporcion_porc_gravada number(3) > Porcentaje del valor gravado del item
[Ejemplo: 10,50,30,0] - tasa_iva number(3) > Tasa del IVA al que pertenece el item
[Ejemplo: 5,10,0] - um number(3) > Codigo de la unidad de medida del producto segun la tabla de SIFEN
4= "DET" 77= "UNI" 79= "kg/m²" 83= "kg" 86= "g" 87= "m" 89= "LT" 90= "MG" 91= "CM" 92= "CM2" 93= "CM3" 94= "PUL" 95= "MM" 96= "MM2" 97= "AA" 98= "ME" 99= "TN" 100= "Hs" 101= "Mi" 102= "Di" 103= "Ya" 108= "MT" 109= "M2" 110= "M3" 569= "ración" 660= "ml" 666= "Se" 869= "ha" 885= "GL" 891= "pm" 2329= "UI" 2366= "CPM" - es_combustible number(1) > Esto sirve para algunos re-calculos necesario, sifen solo acepta 4 digitos en cantidad y combustibles suelen dar mas de 4 digitos para que quede bien los totales
- cantidad decimal(15,4) Cantidad del Servicio/Producto/Item vendido
- (*) ncm char(6-8) > Nomenclatura común del Mercosur (NCM)
- (*) observacion char(1-500) > Observacion del item
- precio_unitario decimal(15,8) > Precio Unitario (precio de lista) del item , no se debe aplicar descuento a este valor
- descuento_unitario decimal(15,8) > Valor del Descuento UNITARIO del producto, expresado en VALOR
Al informar Descuento UNITARIO, no se puede informar Porcentaje - porcentaje_desc decimal(15,8) > Porcentaje del Descuento UNITARIO del producto, expresado en PORCENTAJE (%)
[Ejemplo: 5,10,25]
Al informar Porcentaje, no se puede informar Descuento UNITARIO
Datos de Documentos Asociados (Factura que va vinculada a la Nota de Credito)
sub grupo de datos se debe llamar documentos_asociados (array)
Los Documentos Asociados de la operacion (documentos_asociados) es un Array (Actualmente SIFEN solo permite Asociar 1 Factura a la Nota de Credito)
- (*) cdc_documento_asociado char(44) (todos los 44 digitos deben ser numericos) > CDC de la Factura Asociada a la Nota de Credito
- tipo_documento_asociado number(1) > Tipo de documento asociado
1= Electrónico 2= Impreso 3= Constancia Electrónica - fecha_emision_documento_impreso char(10) > Fecha de la Factura en formato YYYY-MM-DD
[Ejemplo: 2023-01-01] - nro_timbrado_documento_impreso number(8) > Numero del Timbrado de la Factura
- serie_timbrado_factura char(2) > Serie del Timbrado de la Factura (Siempre empieza por la Serie AA)
- establecimiento_documento_impreso char(3) Establecimiento Emisor de la Factura
[Ejemplo: 001,002,003] - expedicion_documento_impreso char(3) Expedicion Emisor
[Ejemplo: 001,002,003] - nro_documento_impreso number(7) > Numero de la Factura
[Ejemplo: 1,2,3,4,etc] - tipo_documento_impreso number(1) > Tipo de documento impreso
1= Factura 2= Nota de crédito 3= Nota de débito 4= Nota de remisión 5= Comprobante de retención
Ejemplo de Estructura en JSON para una NOTA DE CREDITO vinculando una FACTURA ELECTRONICA
{
"operacion": 5,
"cdc": "05800999999999999999999999999999999999999990",
"fecha_documento": "2023-09-25",
"numero_timbrado": "12345678",
"serie_timbrado": "AA",
"fecha_inicio_timbrado": "2023-08-17",
"establecimiento_timbrado": "001",
"expedicion_timbrado": "001",
"numero_documento": 1,
"moneda_operacion": "PYG",
"tipo_impuesto": 1,
"tipo_transaccion": 1,
"codigo_pais_receptor": "PRY",
"condicion_operacion": 2,
"cotizacion_operacion": 0.000,
"tipo_presencia_operacion": 1,
"tipo_receptor": 1,
"tipo_contribuyente_receptor": 2,
"tipo_documento_receptor": 1,
"nombre_receptor": "NOMBRE DEL CLIENTE",
"descripcion_tipo_documento_receptor": "",
"numero_documento_receptor": "1234567",
"ruc_receptor": "1234567-7",
"telefono_receptor": "0983123456",
"observacion": "",
"email_receptor": "",
"direccion_receptor": "Direccion del Receptor",
"tipo_operacion": "B2C",
"descuento_global": 0,
"redondeo_sedeco": 0.00,
"total_operacion": 150000.0000000000,
"registro_sistema": "123",
"id_sucursal": 1,
"items_operacion": [
{
"codigo_interno_sistema": "0024",
"descripcion": "REVIGAL LIMPIA PANA 440 CM3",
"afecta_iva": 1,
"proporcion_porc_gravada": 100.00000,
"tasa_iva": 10.000,
"um": 77,
"es_combustible": 0,
"ncm": null,
"observacion": "",
"precio_unitario": 75000.00000,
"descuento_unitario": 0.00000,
"porcentaje_desc": 0,
"cantidad": 1.00000
},
{
"codigo_interno_sistema": "0023",
"descripcion": "REVIGAL LIMPIA PANA 240 CM3",
"afecta_iva": 1,
"proporcion_porc_gravada": 100.00000,
"tasa_iva": 10.000,
"um": 77,
"es_combustible": 0,
"ncm": null,
"observacion": "",
"precio_unitario": 37500.00000,
"descuento_unitario": 0.00000,
"porcentaje_desc": 0,
"cantidad": 2.00000
}
],
"documentos_asociados": [
{
"tipo_documento_asociado": 1,
"cdc_documento_asociado": "01800999999999999999999999999999999999999990"
}
]
}
Ejemplo de Estructura en JSON para una NOTA DE CREDITO vinculando una FACTURA IMPRESA
{
"operacion": 5,
"cdc": "05800999999999999999999999999999999999999990",
"fecha_documento": "2023-09-25",
"numero_timbrado": "12345678",
"serie_timbrado": "AA",
"fecha_inicio_timbrado": "2023-08-17",
"establecimiento_timbrado": "001",
"expedicion_timbrado": "001",
"numero_documento": 1,
"moneda_operacion": "PYG",
"tipo_impuesto": 1,
"tipo_transaccion": 1,
"codigo_pais_receptor": "PRY",
"condicion_operacion": 2,
"cotizacion_operacion": 0.000,
"tipo_presencia_operacion": 1,
"tipo_receptor": 1,
"tipo_contribuyente_receptor": 2,
"tipo_documento_receptor": 1,
"nombre_receptor": "NOMBRE DEL CLIENTE",
"descripcion_tipo_documento_receptor": "",
"numero_documento_receptor": "1234567",
"ruc_receptor": "1234567-7",
"telefono_receptor": "0983123456",
"observacion": "",
"email_receptor": "",
"direccion_receptor": "Direccion del Receptor",
"tipo_operacion": "B2C",
"descuento_global": 0,
"redondeo_sedeco": 0.00,
"total_operacion": 150000.0000000000,
"registro_sistema": "123",
"id_sucursal": 1,
"items_operacion": [
{
"codigo_interno_sistema": "0024",
"descripcion": "REVIGAL LIMPIA PANA 440 CM3",
"afecta_iva": 1,
"proporcion_porc_gravada": 100.00000,
"tasa_iva": 10.000,
"um": 77,
"es_combustible": 0,
"ncm": null,
"observacion": "",
"precio_unitario": 75000.00000,
"descuento_unitario": 0.00000,
"porcentaje_desc": 0,
"cantidad": 1.00000
},
{
"codigo_interno_sistema": "0023",
"descripcion": "REVIGAL LIMPIA PANA 240 CM3",
"afecta_iva": 1,
"proporcion_porc_gravada": 100.00000,
"tasa_iva": 10.000,
"um": 77,
"es_combustible": 0,
"ncm": null,
"observacion": "",
"precio_unitario": 37500.00000,
"descuento_unitario": 0.00000,
"porcentaje_desc": 0,
"cantidad": 2.00000
}
],
"documentos_asociados": [
{
"tipo_documento_asociado": 2,
"fecha_emision_documento_impreso": "2022-01-13",
"nro_timbrado_documento_impreso": 12345678,
"establecimiento_documento_impreso": "007",
"expedicion_documento_impreso": "001",
"nro_documento_impreso": 47005,
"tipo_documento_impreso": 1
}
]
}