Recepción Paquetes
(Computarizada o Electrónica)
Generar el QR de la factura
Los servicios de facturación tambien realizan la generación del QR para la factura automáticamente.
EndPoint que realiza las operaciones para empaquetar las facturas y enviarlo al SIN, Véase a más detalle computarizada o Véase a más detalle electrónica
Url
La url es la siguiente:
https://sampi-rest.rda-consultores.com/api/v2/paquetesFacturacion
Parámetros (Request)
Visualización en formato JSON
{
"prop_general": {
"codigoPuntoVenta": 0,
"cuis": "codigo_cuis",
"codigoControl": "codigo_control",
"cufd": "codigo_cufd",
"to": "email_cliente"
},
"facturas": [
{
"cabecera": {
"nitEmisor": "nit_del_emisor",
"razonSocialEmisor": "razon_social_emisor",
"municipio": "municipio",
"telefono": "telefono1 - telefono2",
"numeroFactura": 2,
"cuf": "cuf_geenrado_por_la_api, cadena_vacia",
"cufd": "cufd_consultado",
"codigoSucursal": 0,
"direccion": "direccion",
"codigoPuntoVenta": 0,
"fechaEmision": "fecha_actual_en_formato_2024-03-31T19:14:10.053000",
"nombreRazonSocial": "nombre_razon_social",
"codigoTipoDocumentoIdentidad": 1,
"numeroDocumento": "numero_documento",
"complemento": true,
"codigoCliente": 2453,
"codigoMetodoPago": 1,
"numeroTarjeta": null,
"montoTotal": 7,
"montoTotalSujetoIva": 7,
"montoGiftCard": "0.00",
"descuentoAdicional": "0",
"codigoExcepcion": null,
"cafc": null,
"codigoMoneda": "1",
"tipoCambio": "1",
"montoTotalMoneda": 7,
"leyenda": "Ley N° 453: Los contratos de adhesión deben redactarse en términos
claros, comprensibles, legibles y deben informar todas las facilidades
y limitaciones.",
"usuario": "usuario",
"codigoDocumentoSector": 8
},
"detalle": [
{
"actividadEconomica": 620920,
"codigoProductoSin": 99100,
"codigoProducto": "2",
"descripcion": "Aros",
"cantidad": "1",
"unidadMedida": 42,
"precioUnitario": "2",
"montoDescuento": 0,
"subTotal": "2",
"numeroSerie": null,
"numeroImei": null
},
{
"actividadEconomica": 620920,
"codigoProductoSin": 99100,
"codigoProducto": "1",
"descripcion": "Producto Sony",
"cantidad": "1",
"unidadMedida": 40,
"precioUnitario": "5",
"montoDescuento": 0,
"subTotal": "5",
"numeroSerie": null,
"numeroImei": null
}
]
},
{
"cabecera": {
"nitEmisor": "nit_del_emisor",
"razonSocialEmisor": "razon_social_emisor",
"municipio": "municipio",
"telefono": "telefono1 - telefono2",
"numeroFactura": 2,
"cuf": "cuf_geenrado_por_la_api, cadena_vacia",
"cufd": "cufd_consultado",
"codigoSucursal": 0,
"direccion": "direccion",
"codigoPuntoVenta": 0,
"fechaEmision": "fecha_actual_en_formato_2024-03-31T19:14:10.053000",
"nombreRazonSocial": "nombre_razon_social",
"codigoTipoDocumentoIdentidad": 1,
"numeroDocumento": "numero_documento",
"complemento": true,
"codigoCliente": 2453,
"codigoMetodoPago": 1,
"numeroTarjeta": null,
"montoTotal": 7,
"montoTotalSujetoIva": 7,
"montoGiftCard": "0.00",
"descuentoAdicional": "0",
"codigoExcepcion": null,
"cafc": null,
"codigoMoneda": "1",
"tipoCambio": "1",
"montoTotalMoneda": 7,
"leyenda": "Ley N° 453: Los contratos de adhesión deben redactarse en términos
claros, comprensibles, legibles y deben informar todas las facilidades
y limitaciones.",
"usuario": "usuario",
"codigoDocumentoSector": 2
},
"detalle": [
{
"actividadEconomica": 620920,
"codigoProductoSin": 99100,
"codigoProducto": "2",
"descripcion": "Aros",
"cantidad": "1",
"unidadMedida": 42,
"precioUnitario": "2",
"montoDescuento": 0,
"subTotal": "2",
"numeroSerie": null,
"numeroImei": null
},
{
"actividadEconomica": 620920,
"codigoProductoSin": 99100,
"codigoProducto": "1",
"descripcion": "Producto Sony",
"cantidad": "1",
"unidadMedida": 40,
"precioUnitario": "5",
"montoDescuento": 0,
"subTotal": "5",
"numeroSerie": null,
"numeroImei": null
}
]
}
]
}
Los parámetros necesarios, se especifican en la siguiente tabla:
Propiedades Generales (prop_general)
| Elemento | Descripción |
|---|---|
| codigoPuntoVenta | Código de la Sucursal. |
| cuis | Código CUIS. |
| codigoControl | Código de Control (Proviene de la petición CUFD). |
| cufd | Código CUIS. |
| to | Correo del Cliente a quien se le enviará el correo con los archivos PDF's y XML's. |
Facturas
En la estructura de solicitud se necesita de las facturas, por lo que este es un array de conjunto de facturas en cualquier orden de documento sector, pero siguiendo la estructura de recepcionFactura osea cabecera y detalle, como se ve en Recepción Factura, este parámetro es "facturas".
Devolución (Response)
La consulta devuelta tendrá el siguiente formato de ejemplo:
En caso de éxito
{
"status_api": 200,
"description": "ok",
"content": {
"content_sin": [
{
"codigoDescripcion": "PENDIENTE",
"codigoEstado": 901,
"codigoRecepcion": "9bb376f5-8f20-11ef-bcb1-17ac0a3eef0a",
"transaccion": true
}
],
"content_api": [
{
"codigoDocumentoSector": 46,
"codigoRecepcion": "9bb376f5-8f20-11ef-bcb1-17ac0a3eef0a"
}
],
"facturas": {
"sectorEducativoZF": [
{
"numeroFactura": 1000,
"cuf": "1CA88D17316F49EE9999D8ADFABF238B31A3E8E10C6B864D90C919E74"
},
{
"numeroFactura": 501,
"cuf": "1CA88D17316F49EE9958D0D7B49310A97A42EF772B6B864D90C919E74"
},
{
"numeroFactura": 502,
"cuf": "1CA88D17316F49EE9958ECF77C4487E109A4F0FDCF6B864D90C919E74"
},
{
"numeroFactura": 503,
"cuf": "1CA88D17316F49EE9959091743F5FF189906F2846D6B864D90C919E74"
},
{
"numeroFactura": 504,
"cuf": "1CA88D17316F49EE9959260ACDC3451D1609F40B0F6B864D90C919E74"
},
{
"numeroFactura": 505,
"cuf": "1CA88D17316F49EE99594156D358ED87B7CAF591AA6B864D90C919E74"
},
{
"numeroFactura": 999,
"cuf": "1CA88D17316F49EE9999AC0308E1845111ADE75A6E6B864D90C919E74"
}
]
}
}
}
En caso de conflicto
-
Cuando cualquier parámetro no es el adecuado, se obtendrá la siguiente respuesta, pero es ambigua:
{
"status_api": 409,
"description": "Conflicto",
"content": {
"codigoDescripcion": "RECHAZADA",
"codigoEstado": 902,
"mensajesList": [
{
"codigo": 954,
"descripcion": "LA CANTIDAD DE FACTURAS EN EL PAQUETE EMITIDO POR CONTINGENCIA HA EXCEDIDO EL MAXIMO PERMITIDO facturas enviadas 1000, maximo 500"
}
],
"transaccion": false
}
}