Confirmación de Compras
Servicio que permite la confirmación de compras registradas. Si los parámetros enviados son correctos, el servicio confirma las compras, caso contrario, devuelve los códigos de error correspondientes.
El servicio implementado posee un objeto denominado SolicitudConfirmacionCompras el cual contiene la información descrita en el siguiente cuadro:
|
Nombre Método: confirmacionCompras |
|
||||||
|
Entrada |
Tipo Dato |
Obligatorio |
Descripción |
Salida |
Tipo Dato |
||
|
codigoAmbiente |
Numérico |
Si |
Describe el tipo de ambiente utilizado, los valores permitidos son: Producción: 1 Pruebas y Piloto: 2 |
codigoEstado |
Numérico |
||
|
codigoPuntoVenta |
Numérico |
No |
Solo se envía cuando la transacción se realiza utilizando un punto de venta. Caso contrario enviar 0. |
codigoRecepcion |
Alfanumérico |
||
|
codigoSistema |
Alfanumérico |
Si |
Código de Sistema que le fue asignado al momento de realizar la solicitud de autorización. |
codigosRespuestas |
DTO[codigosRespuesta] |
||
|
codigoSucursal |
Numérico |
Si |
Valor que identifica a la sucursal donde se realiza la emisión de la Factura: Casa Matriz: 0 Sucursal: 1,2,..,n |
transaccion |
Boolean |
||
|
cufd |
Alfanumérico |
Si |
Valor diario otorgado por el SIN. |
codigoDescripcion |
Alfanumérico |
||
|
cuis |
Alfanumérico |
Si |
Valor único para una sucursal y/o punto de venta que se obtiene al realizar el inicio de uso de sistemas. |
|
|
||
|
nit |
Numérico |
Si |
NIT perteneciente al comprador |
|
|
||
|
archivo |
Alfanumérico |
Si |
Paquete de facturas enviadas para su confirmación |
|
|
||
|
cantidadFacturas |
Numérico |
Si |
Cantidad de facturas enviadas |
|
|
||
|
fechaEnvio |
Timestamp |
Si |
Fecha y Hora de Envío |
|
|
||
|
gestion |
Numérico |
Si |
Gestión correspondiente a las facturas enviadas |
|
|
||
|
hash |
Alfanumérico |
Si |
Sha256 de la cadena que se envía |
|
|
||
|
periodo |
Numérico |
Si |
Periodo correspondiente a las facturas enviadas |
|
|
||
Nota: Para poder consumir este servicio se debe: Generar Archivo XML, validar el mismo contra el XSD asociado a objeto de comprobar que el XML está bien formado y se ajusta a una estructura definida. Almacenar temporalmente de manera individual las Facturas generadas. Recuperar los XMLś almacenadas y Formar paquetes de hasta 500 Facturas y empaquetarlas en un contenedor TAR (paquete.tar). Comprimir con Gzip al archivo del contenedor TAR (ejemplo: paquete.tar.gz), mismo que debe ser enviado en la etiqueta archivo. Obtener el HASH (SHA256) del archivo compreso obtenido en el paso anterior, mismo que debe ser enviado en la etiqueta hash.
Los Archivos XML a ser enviados se elaboran a partir de la información recuperada del SIN a través del servicio Consulta de Compras a Confirmar.