INFORMACIÓN TÉCNICA. Mensajes de Envió y Respuesta en el Ingreso al Almacén

Transcripción

1 1 de 3 INFORMACIÓN TÉCNICA Mensajes de Envió y Respuesta en el Ingreso al Almacén ENERO /01/2004

2 2 de 3 OBJETIVO El objetivo de este documento es describir el formato de envió y respuesta de los mensajes que se utilizan en el ingreso al almacén. INSTRUCTIVO Para la realización de la pruebas de transmisión se han publicado hasta el momento tres servicios utilizados en el ingreso de la mercadería al almacén courier, que se encuentran en el siguiente URL: Estos servicios son:?? registraringresoalmacen.- Se lo utiliza cada vez que se requiera ingresar la información de una guía o más, con su peso real registrado en el momento del ingreso al almacén.?? actualizaringresoalmacen.- Se lo utiliza cada vez que se quiera actualizar un peso mal ingresado con su respectiva justificación.?? eliminaringresoalmacen.- Se lo utiliza solamente en el caso de que se desee eliminar el mal ingreso de un bulto perteneciente a un multipaquete por haber sido ingresada más de una vez con una secuencia diferente, con su respectiva justificación. MENSAJE DE ENVIÓ PARA UN INGRESO DE GUÍA AL ALMACÉN. Formato: Elemento Tipo Dato Longitud Obligatorio <guia-courier id=""> numérico indefinido si <aduana-manifiesto> numérico 3 si <anio-manifiesto> numérico 4 si <tipo-manifiesto> numérico 2 si <numero-manifiesto> numérico 6 si <puerto-embarque> alfanumérico 5 si <linea-transportista> numérico 4 si <numero-documento-transporte> alfanumérico 1 a 25 si <almacen-aduanero> numérico 4 si <consolidador-courier-carga> numérico 4 si <fecha-hora-transaccion> alfanumérico 19 si <tipo-aforo> alfanumérico 1 no <secuencia> numérico 1 a 4 si <peso-bulto-detalle> Decimal (11,2) 14 si 15/01/2004

3 3 de 3 Elemento <guia-courier id=""> <aduana-manifiesto> <anio-manifiesto> <tipo-manifiesto> <numero-manifiesto> <puerto-embarque> <linea-transportista> <numero-documento-transporte> <almacen-aduanero> <consolidador-courier-carga> <fecha-hora-transaccion> <tipo-aforo> <secuencia> <peso-bulto-detalle> Descripción Se pueden enviar de 1 a n guías courier, identificadas por el atributo id que inicia con 1, este elemento agrupa los elementos de abajo. Este elemento contiene la identificación de la aduana de descarga de la mercancía Contiene el año de generación del número del manifiesto de carga Contiene la identificación de la vía de transporte por el que la carga arriba a la aduana Contiene el número del manifiesto que corresponde al número secuencial asignado por la aduana al manifiesto Contiene el puerto donde se embarcan las mercancías Contiene la identificación del Agente Operador de la Carga o Transportista que emite el documento de transporte padre (Master). Contiene el número de la Guía Courier Contiene el código del almacén temporal en que será almacenada la carga. Este campo contiene la información de la Empresa de Servicio Expreso Courier de la mercancía, que es la que envía el presente informe Indica la fecha y hora en la que ingreso el paquete al almacén. Su formato debe ser dd/mm/yyyy HH:mm:ss (15/01/ :50:03) Se lo envía solamente en el caso de querer cambiar el aforo a físico de un documento. En caso de querer cambiar el tipo de aforo su valor es F. Indica la secuencia del paquete. En caso de ser una guía que tiene asociado múltiples paquetes su secuencia inicia de 1 a n múltipaquetes que tenga la guía. En caso de ser una guía sin multipaquetes, el valor de la secuencia es 1. Contiene el peso bruto real en kilogramos del paquete pesado al momento del ingreso al almacén 15/01/2004

4 4 de 4 Ejemplo: <?xml version = '1.0' encoding = 'UTF-8'?> <SOAP-ENV:Envelope xmlns:soap-env=" xmlns:xsi=" xmlns:xsd=" <SOAP-ENV:Body> <ns1:registraringresoalmacen xmlns:ns1="almacencourierws" SOAP- ENV:encodingStyle=" <elem> <mensajeingresoalmacen> <guia-courier id="1"> <numero-documento-transporte> </numero-documento-transporte> <tipo-aforo>f</tipo-aforo> <secuencia>1</secuencia> <peso-bulto-detalle>2.46</peso-bulto-detalle> <guia-courier id="2"> <numero-documento-transporte> </numero-documento-transporte> <fecha-hora-transaccion>17/11/ :40:11</fecha-hora-transaccion> <secuencia>1</secuencia> <peso-bulto-detalle>5.16</peso-bulto-detalle> <guia-courier id="3"> <numero-documento-transporte> </numero-documento-transporte> <fecha-hora-transaccion>17/11/ :40:12</fecha-hora-transaccion> <secuencia>2</secuencia> <peso-bulto-detalle>8.12</peso-bulto-detalle> <guia-courier id="4"> <numero-documento-transporte> </numero-documento-transporte> 15/01/2004

5 5 de 5 <fecha-hora-transaccion>17/11/ :40:13</fecha-hora-transaccion> <secuencia>1</secuencia> <peso-bulto-detalle>2.16</peso-bulto-detalle> </mensajeingresoalmacen> </elem> </ns1:registraringresoalmacen> </SOAP-ENV:Body> </SOAP-ENV:Envelope> MENSAJE DE ENVIÓ PARA UNA ACTUALIZACIÓN DE UNA GUÍA INGRESADA. Formato: Elemento Tipo Dato Longitud Obligatorio <guia-courier id=""> numérico indefinido si <aduana-manifiesto> numérico 3 si <anio-manifiesto> numérico 4 si <tipo-manifiesto> numérico 2 si <numero-manifiesto> numérico 6 si <puerto-embarque> alfanumérico 5 si <linea-transportista> numérico 4 si <numero-documento-transporte> alfanumérico 1 a 25 si <almacen-aduanero> numérico 4 si <consolidador-courier-carga> numérico 4 si <fecha-hora-transaccion> alfanumérico 19 si <secuencia> numérico 1 a 4 si <peso-bulto-detalle> Decimal (11,2) 14 si <justificacion> Alfanumérico 210 si Elemento <guia-courier id=""> <aduana-manifiesto> <anio-manifiesto> <tipo-manifiesto> <numero-manifiesto> <puerto-embarque> <linea-transportista> Descripción Se pueden enviar de 1 a n guías courier, identificadas por el atributo id que inicia con 1, este elemento agrupa los elementos de abajo. Este elemento contiene la identificación de la aduana de descarga de la mercancía Contiene el año de generación del número del manifiesto de carga Contiene la identificación de la vía de transporte por el que la carga arriba a la aduana Contiene el número del manifiesto que corresponde al número secuencial asignado por la aduana al manifiesto Contiene el puerto donde se embarcan las mercancías Contiene la identificación del Agente Operador de la Carga o Transportista que emite el documento de transporte padre (Master). 15/01/2004

6 6 de 6 <numero-documento-transporte> <almacen-aduanero> <consolidador-courier-carga> <fecha-hora-transaccion> <secuencia> <peso-bulto-detalle> <justificacion> Contiene el número de la Guía Courier Contiene el código del almacén temporal en que será almacenada la carga. Este campo contiene la información de la Empresa de Servicio Expreso Courier de la mercancía, que es la que envía el presente informe Indica la fecha y hora en la que realizan la. Su formato debe ser dd/mm/yyyy HH:mm:ss (15/01/ :50:03) Indica la secuencia del paquete. En caso de ser una guía que tiene asociado múltiples paquetes su secuencia inicia de 1 a n múltipaquetes que tenga la guía. En caso de ser una guía sin multipaquetes, el valor de la secuencia es 1. Contiene el peso bruto real en kilogramos del paquete pesado al momento del ingreso al almacén Justificación por el motivo de la actualización del peso. Ejemplo: En este ejemplo se realiza una actualización a una guía enviada en el ejemplo anterior <?xml version = '1.0' encoding = 'UTF-8'?> <SOAP-ENV:Envelope xmlns:soap-env=" xmlns:xsi=" xmlns:xsd=" <SOAP-ENV:Body> <ns1:registraringresoalmacen xmlns:ns1="almacencourierws" SOAP- ENV:encodingStyle=" <elem> <mensajeingresoalmacen> <guia-courier id="1"> <numero-documento-transporte> </numero-documento-transporte> <secuencia>1</secuencia> <peso-bulto-detalle>3.20</peso-bulto-detalle> <justificacion>se realizo el cambio en el peso por motivo de un mal pesaje debido al daño en la balanza </justificacion> </mensajeingresoalmacen> </elem> </ns1:registraringresoalmacen> </SOAP-ENV:Body> </SOAP-ENV:Envelope> 15/01/2004

7 7 de 7 MENSAJE DE ENVIÓ PARA UNA ELIMINACIÓN DE UN BULTO PERTENECIENTE A UN MULTIPAQUETE DE UNA GUÍA INGRESADA. Formato: Elemento Tipo Dato Longitud Obligatorio <guia-courier id=""> numérico indefinido si <aduana-manifiesto> numérico 3 si <anio-manifiesto> numérico 4 si <tipo-manifiesto> numérico 2 si <numero-manifiesto> numérico 6 si <puerto-embarque> alfanumérico 5 si <linea-transportista> numérico 4 si <numero-documento-transporte> alfanumérico 1 a 25 si <almacen-aduanero> numérico 4 si <consolidador-courier-carga> numérico 4 si <fecha-hora-transaccion> alfanumérico 19 si <secuencia> numérico 1 a 4 si <justificacion> Alfanumérico 210 si Elemento <guia-courier id=""> <aduana-manifiesto> <anio-manifiesto> <tipo-manifiesto> <numero-manifiesto> <puerto-embarque> <linea-transportista> <numero-documento-transporte> <almacen-aduanero> <consolidador-courier-carga> <fecha-hora-transaccion> <secuencia> Descripción Se pueden enviar de 1 a n guías courier, identificadas por el atributo id que inicia con 1, este elemento agrupa los elementos de abajo. Este elemento contiene la identificación de la aduana de descarga de la mercancía Contiene el año de generación del número del manifiesto de carga Contiene la identificación de la vía de transporte por el que la carga arriba a la aduana Contiene el número del manifiesto que corresponde al número secuencial asignado por la aduana al manifiesto Contiene el puerto donde se embarcan las mercancías Contiene la identificación del Agente Operador de la Carga o Transportista que emite el documento de transporte padre (Master). Contiene el número de la Guía Courier Contiene el código del almacén temporal en que será almacenada la carga. Este campo contiene la información de la Empresa de Servicio Expreso Courier de la mercancía, que es la que envía el presente informe Indica la fecha y hora en la que realizan la. Su formato debe ser dd/mm/yyyy HH:mm:ss (15/01/ :50:03) Indica la secuencia del paquete. En caso de ser una guía que 15/01/2004

8 8 de 8 <justificacion> tiene asociado múltiples paquetes su secuencia inicia de 1 a n múltipaquetes que tenga la guía. En caso de ser una guía sin multipaquetes, el valor de la secuencia es 1. Justificación por el motivo de la eliminación del bulto Ejemplo: En este ejemplo se realiza una eliminación a un bulto perteneciente a un multipaquete de una guía ingresada en el primer ejemplo. <?xml version = '1.0' encoding = 'UTF-8'?> <SOAP-ENV:Envelope xmlns:soap-env=" xmlns:xsi=" xmlns:xsd=" <SOAP-ENV:Body> <ns1:registraringresoalmacen xmlns:ns1="almacencourierws" SOAP- ENV:encodingStyle=" <elem> <mensajeingresoalmacen> <guia-courier id="1"> <numero-documento-transporte> </numero-documento-transporte> <secuencia>2</secuencia> <justificacion>se realizo la eliminación por motivo de un doble escáner sobre el mismo bulto </justificacion> </mensajeingresoalmacen> </elem> </ns1:registraringresoalmacen> </SOAP-ENV:Body> </SOAP-ENV:Envelope> MENSAJE DE RESPUESTA PARA UN INGRESO, ACTUALIZACIÓN Y ELIMINACIÓN DE UNA GUÍA INGRESADA. Formato: Elemento Tipo Dato Longitud Obligatorio <guia-courier id=""> numérico indefinido si <indicador-aceptacion> numérico 2 si <fecha-hora-transaccion> alfanumérico 19 si <indicador-no-manifestado> numérico 2 no <tipo-aforo> numérico 1 no <codigo-error-proceso> numérico 4 no <codigo-descripcion-proceso> alfanumérico 200 no 15/01/2004

9 9 de 9 Elemento Descripción <guia-courier id=""> Respuesta de 1 a n guías courier que fueron enviadas, identificadas por el atributo id que inicia con 1, este elemento agrupa los elementos de abajo. Si el id es igual a 0 es porque la estructura del documento xml que se envió a la CAE estaba mal, y en este caso se enviara un solo elemento guia-courier como respuesta <indicador-aceptacion> Su valor será 00 cuando la guía fue aceptada y 03 cuando la guía fue rechazada. <fecha-hora-transaccion> Indica la fecha y hora en la que se acepto o rechazo la transacción. Su formato debe ser dd/mm/yyyy HH:mm:ss (15/01/ :50:03) <indicador-no-manifestado> Su valor será 01 cuando la guía no se encuentre manifestada, pero se aceptará esa guía. Es opcional, y solo se lo enviará cuando se haga un ingreso de una guía que no este manifestada, no se lo enviará cuando se haga una actualización o eliminación. <tipo-aforo> Su valor será F cuando se haga un cambio de aforo documental a físico. Es opcional, y solo se lo enviará cuando se haga un ingreso de una guía, no se lo enviará cuando se haga una actualización o eliminación. <codigo-error-proceso> Es un código que indica el error que haya en la información enviada, por guía courier. Solo se lo enviará en caso de haber un error. <codigo-descripcion-proceso> Es la descripción del error. Solo se lo enviará en el caso de haber un error. Nota: Los códigos de error con su respectiva descripción serán los que genere el validador para estos tipos de mensaje, el cual esta en proceso de modificación para que acepte este tipo de mensaje y puedan ser validados. Ejemplo: <?xml version = '1.0' encoding = 'UTF-8'?> <SOAP-ENV:Envelope xmlns:soap-env=" xmlns:xsi=" xmlns:xsd=" <SOAP-ENV:Body> <ns1:registraringresoalmacenresponse xmlns:ns1="almacencourierws" SOAP- ENV:encodingStyle=" <return> <mensajerespuesta> <guia-courier id="1"> <indicador-aceptacion>00</indicador-aceptacion> <indicador-no-manifestado>0164</indicador-no-manifestado> <tipo-aforo>f</tipo-aforo> 15/01/2004

10 10 de 10 <guia-courier id="2"> <indicador-aceptacion>00</indicador-aceptacion> <guia-courier id="3"> <indicador-aceptacion>03</indicador-aceptacion> <errores> <error> <codigo-error-proceso>0001</codigo-error-proceso> <codigo-descripcion-proceso>se encuentra mal ingresado el tipo de manifiesto</codigodescripcion-proceso> </error> <error> <codigo-error-proceso>0002</codigo-error-proceso> <codigo-descripcion-proceso>se encuentra mal ingresado el codigo del Courier</codigodescripcion-proceso> </error> </errores> </mensajerespuesta> </return> </ns1:registraringresoalmacenresponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope> 15/01/2004