Webserviceesp

Descargar como pdf o txt
Descargar como pdf o txt
Está en la página 1de 43

WEB SERVICIE

Versión : V-5.7

Fecha : Octubre

2020
Actualizaciones

Versión Fech Comentar


a io

V-1 Julio de 2006 Creación de documentos

V-2.8 Agosto 2011 Revisión de la lista y capítulo añadido

V-2.8.1 Octubre 2011 Tabla de corrección del código de


devolución

V-3 Junio de 2012 Actualización del método WSI3

V-3.1 Agosto 2012 Actualización de los métodos disponibles

V- 4 Noviembre 2012 Segmentación de Points Relais

V-5 Septiembre 2015 Actualización

V-5.1 Junio de 2016 Actualización WSI3_GetEtiquette : 10x15

V-5.2 Abril 2017 Proceso de pruebas y validaciones

V-5.3 Octubre 2017 Taquillas

V-5.4 Marzo 2018 Actualizar el método


WSI3_PointRelais_Recherche a
WSI4_PointRelais_Recherche
Casilleros eliminados

V-5.5 Julio de 2018 Correcciones

V-5.6 Noviembre 2018 Ejemplo de algoritmo para


CRC Stat 92
Código postal REGEX

V-5.7 Octubre 2020 Supresión de 24X


Contenido
Terminología .................................................................................................................................................... 4
Web Service......................................................................................................................................... 4
Método de Web Service ...................................................................................................................... 4
Expresión regular ................................................................................................................................ 4
Modos de recogida y entrega .............................................................................................................. 4
Norma ISO ........................................................................................................................................... 5
Hash MD5 ............................................................................................................................................ 5
Transferencia XML................................................................................................................................ 5
Web Service...................................................................................................................................................... 6
Especificaciones generales para los intercambios .............................................................................. 6
Descripción general ............................................................................................................................. 6
Funcionamiento normal y depuración ................................................................................................ 6
Regularidad de las convocatorias ........................................................................................................ 6
Información sobre los métodos del Web Service ................................................................................ 6
Generación de la clave de seguridad ................................................................................................... 7
Impresión de etiquetas ....................................................................................................................... 8
Los métodos del Web Service de Mondial Relay ............................................................................................. 9
Búsqueda de Point Relais .................................................................................................................... 9
Búsqueda por código postal .............................................................................................................. 14
Creación de envíos ............................................................................................................................ 16
Creación de etiquetas ....................................................................................................................... 23
Seguimiento de paquetes ................................................................................................................. 29
Recuperación de etiquetas concatenadas ......................................................................................... 31
Lista de códigos de estado ................................................................................................................ 32
Códigos de estado .......................................................................................................................................... 33
Ejemplos de códigos ....................................................................................................................................... 39
Lenguaje C# ....................................................................................................................................... 39
Función de generación de Hash MD5 (Message Digest 5) ................................................... 39
Función de generación de Hash SHA1 (Secure Hash Algorithm) .......................................... 39
Método de solicitud " WSI4_PointRelais_Recherche " al WebService con Visual Studio..... 39
Lenguaje PHP ..................................................................................................................................... 41
Método de solicitud " WSI4_PointRelais_Recherche " al Web Service con nuSOAP ........... 41
Lenguaje ASP3 ................................................................................................................................... 43
Método de solicitud " WSI4_PointRelais_Recherche " al WebService con Msxml2............. 43
Terminología

Web Service
El término "Servicio Web" representa un programa informático que permite la comunicación y el
intercambio de información entre aplicaciones y sistemas heterogéneos en entornos distribuidos.
Se trata, pues, de un conjunto de funcionalidades presentadas en Internet o en una Intranet, por y
para aplicaciones o máquinas, sin intervención humana y en tiempo real. El Servicio Web se llama a
través de una URL y lleva un nombre de archivo.
Los programas informáticos están escritos en varios lenguajes de programación y en varias plataformas
pueden utilizar servicios web para intercambiar datos a través de redes informáticas como Internet.
Esta interoperabilidad se debe al uso de normas abiertas agrupadas en el término genérico SOA (Service
Oriented Architecture).
La principal ventaja del uso del Servicio Web es el intercambio automático de flujos de información en
tiempo real con los servidores de Mondial Relay, a diferencia de los intercambios de archivos (vía ftp) que
tienen lugar a intervalos regulares durante el día.
Los servicios web utilizan estándares y protocolos abiertos. Todos los datos de intercambio están
formateados en XML. Esta codificación puede realizarse mediante SOAP o XML-RPC. Basados en el
protocolo HTTP, los Servicios Web pueden funcionar a través de numerosos cortafuegos sin necesidad de
modificar los filtros.
Para más información, consulte: http://fr.wikipedia.org/wiki/Service_Web
Mondial Relay no se hace responsable del contenido de la página anterior y no puede garantizar la
información.

Método de Web Service


El término "método del Servicio Web" representa la funcionalidad entre un conjunto en el Servicio
Web. Un método del Servicio Web se llama a través de un parámetro enviado al Servicio Web que
lo contiene.
Expresión regular
Una expresión regular es una cadena de caracteres.
Las expresiones regulares son utilizadas hoy en día por los informáticos en la publicación y el control de
textos, así como en el uso de lenguajes formales que forman parte de los lenguajes informáticos.
Modos de recogida y entrega
Esta es una lista no exhaustiva de los modos de entrega.
24R : Entrega de Point
Relais® 24L : Entrega de Point
Relais® XL DRI : Entrega de
Colis drive
LD1 : Entrega a domicilio (1 repartidor)
LDS : Entrega a domicilio (2
repartidores) HOM : Entrega a
domicilio <30Kg
LCC : Devolución

Tenga en cuenta que las modalidades y opciones de entrega (contra reembolso, envío de varios
paquetes, etc.) presentadas en este documento no están disponibles para todos los contratos
(offrestart). Su contacto comercial podrá informarle sobre su contrato.
Norma ISO
El documento hace referencia a dos normas ISO para identificar los países y las lenguas.

La norma de referencia para los códigos de país es la ISO 3166-1. Mondial Relay sólo utiliza el
código "alpha-2" de esta norma.

Para más información, consulte: http://en.wikipedia.org/wiki/ISO_3166-1

La norma de referencia para los códigos lingüísticos es la ISO 639-1.

Para más información, consulte: http://en.wikipedia.org/wiki/ISO_639-1

Mondial Relay no se responsabiliza del contenido de estas páginas y no puede garantizar la


información que contienen.

El sitio web de Mondial Relay™ no incluye todos los países y códigos de idioma presentes en la ISO
normas mencionadas anteriormente.

Para obtener la lista de países e idiomas permitidos, infórmese en Mondial Relay™.

NB : Gestionamos Mónaco con el código de país FR ISO

Hash MD5
El algoritmo MD5 Message-Digest es una función hash criptográfica ampliamente utilizada que
produce un valor hash de 128 bits (16 bytes). Especificado en el RFC 1321, MD5 se ha empleado
en una amplia variedad de aplicaciones de seguridad, y también se utiliza habitualmente para
comprobar la integridad de los datos. Un hash MD5 se expresa normalmente como un número
hexadecimal de 32 dígitos.

Para más información, consulte la siguiente página: http://en.wikipedia.org/wiki/MD5

Mondial Relay™ no se hace responsable del contenido de esta página y no puede garantizar la información
de la misma.
Transferencia XML
XML es un metalenguaje. Es una herramienta que generaliza el principio del etiquetado lógico y
permite construir lenguajes de etiquetado para representar los documentos en términos de
estructuras lógicas, independientemente de su modo de procesamiento. El etiquetado lógico tiene
lugar en el siguiente orden :

• Identificación de la estructura formal del documento. La esencia del documento se describe


identificando los distintos elementos que lo constituyen,
• Etiquetado del documento de acuerdo con la estructura formal definida.
Web Service

Especificaciones generales para los intercambios


Descripción general
Esta sección de la documentación describe las principales funcionalidades para la interconexión del
sitio web de Mondial Relay con los sitios web de comerciantes externos. El principio de
comunicación se basa en el servicio web.
El servicio web que le proporciona Mondial Relay es:
http://api.mondialrelay.com/Web_Services.asmx

https://api.mondialrelay.com/Web_Services.asmx

Todas las llamadas al método del Servicio Web estarán aseguradas con una clave de control. El
algoritmo para el cálculo de esta clave de control se detalla más adelante en este documento.

Credenciales de prueba:
• Enseigne (marca): BDTEST13
• Clave privada: PrivateK

Funcionamiento normal y depuración


En modo normal, el Servicio Web debe devolver siempre el código 0 (operación exitosa) o los
códigos 80 a 83 (códigos de seguimiento). Los demás códigos se utilizan para la depuración durante
la fase de programación y la fase de depuración. Es necesario configurar todos los filtros para
corregir los errores en los parámetros. Durante la fase de producción, no debe utilizar los códigos
de error dados por el Servicio Web para una corrección manual de las solicitudes.

Debe ponerse en contacto con el Departamento de Informática de Mondial Relay si necesita ayuda para
configurar los filtros.

Regularidad de las convocatorias


En modo normal, el método Web Service de Mondial Relay no debe ser llamado en "batch", es decir que
las llamadas no deben ser agrupadas en un gran lote de llamadas, durante la noche por ejemplo. Las
llamadas deben repartirse durante todo el día y la noche, en relación con las necesidades de los
usuarios finales (búsqueda de PUP
/ pedidos / etc.). Este tipo de organización es necesaria para no causar problemas a otros usuarios
del Servicio Web debido a una monopolización demasiado grande de los recursos de nuestros
servidores.

Información sobre los métodos del Servicio Web


El Servicio Web de Mondial Relay puede tener otros métodos distintos a los mostrados en la
presente documentación. Por lo general, se trata de versiones antiguas o de versiones que estamos
desarrollando actualmente. Por favor, no intente utilizarlas.
Por favor, encuentre los métodos disponibles:
WSI2_CreationExpedition WSI4_PointRelais_Recherche WSI3_GetEtiquettes
WSI2_CreationEtiquette WSI2_TracingColisDetaille WSI2_STAT_Label
WSI2_RechercheCP

Generación de la clave de seguridad


Método
El algoritmo para el cálculo de la clave de seguridad es el mismo para todos los métodos disponibles
del Servicio Web de Mondial Relay. El método consiste en la concatenación de todos los
parámetros de entrada, en el orden de la presente documentación, teniendo en cuenta los
parámetros opcionales (excepto si se mencionan). El resultado de la primera concatenación se
agrupa con la clave privada de la marca (normalmente de 8 dígitos). En el siguiente paso este
resultado se encripta de forma no reversible mediante el algoritmo Hash MD5. Este algoritmo MD5
devuelve una clave de 32 dígitos. Para el uso de esta clave en un Servicio Web, debe ser insertada
en MAYÚSCULAS (a menos que se especifique lo contrario).

Ejemplo
Cálculo del método " WSI3_GetEtiquettes " con los siguientes parámetros:

• Enseigne = " BDTEST13 "


• Expediciones = "12345678 "
• Idioma = "FR"

Y la siguiente clave privada: " PrivateK ".

El resultado de la concatenación da la siguiente cadena de caracteres: "


BDTEST1312345678FRPrivateK ".

Se puede observar la presencia de todos los parámetros mencionados en el orden correcto en el


documento, los parámetros opcionales al estar vacíos, no aparecen en la concatenación, pero en
caso de que se especifiquen, se debe tener en cuenta.

A continuación, se aplica el algoritmo MD5 a esta cadena, el algoritmo es bien conocido en el


campo de la programación, este método de generación no se da aquí.

El resultado del algoritmo MD5 es: 33da5f122daa40241087cc7845bea4b1

Como el resultado debe estar en mayúsculas, el parámetro "


Seguridad " es : 33DA5F122DAA40241087CC7845BEA4B1
Cálculo en línea http://www.cryptage.org/outil-crypto-hachage.html

Mondial Relay no es responsable del contenido de estas páginas y no puede dar ninguna garantía
sobre la información que contiene.
.NET ejemplo:

public static string MD5(string data)


{
byte[] buffer = System.Text.Encoding.Default.GetBytes(data);
System.Security.Cryptography.MD5CryptoServiceProvider md5Provider = new
System.Security.Cryptography.MD5CryptoServiceProvider(); byte[] bufferHash
= md5Provider.ComputeHash(buffer); StringBuilder retour = new
StringBuilder(); foreach (Byte b in bufferHash) {
retour.Append(b.ToString("X2")); } return retour.ToString();
}

Ejemplo de JAVA:

intentar {
MessageDigest messageDigest = MessageDigest. getInstance("MD5"); byte[]
b = messageDigest.digest(s.getBytes(Charset. forName("UTF-
8"))); BigInteger bigint = new BigInteger(1, b);
System.out.println(String.format("%032X", bigint));
} catch (NoSuchAlgorithmException e) {
System.err.println("No such algorithm");
}

Impresión de etiquetas
Las etiquetas deben imprimirse en una etiqueta blanca y su tamaño puede ser A4, A5 o 10x15.

- Si utiliza el método del WebService WSI2_CreationEtiquette, debe recuperar las etiquetas en


archivos PDF generados por el WebService, estos PDF no deben ser redimensionados. El
WebService devuelve diferentes formatos de etiqueta: A4, A5 o 10x15 (debe elegir uno de estos
formatos).
- Si utiliza el método de WebService WSI2_CreationExpédition, debe generar la etiqueta Mondial
Relay. Debe consultar el archivo de especificación de etiquetas, disponible con el enlace:
http://www.mondialrelay.fr/solutionspro/documentation-technique/cahier-descharges-
informatiques/
Este archivo contiene todas las normas y especificaciones de las etiquetas, así como las normas
de las pruebas y validaciones. Las pruebas de las etiquetas también pueden tener lugar
después de la puesta en marcha, lo que puede dar lugar a ajustes basados en este archivo de
especificaciones.
Los métodos del Web Service de Mondial Relay
Búsqueda de Point Relais
Este método permite buscar los 30 Points Relais® más cercanos a partir de una ubicación
determinada (a partir de una dirección GPS o por código postal/país). Los resultados se pueden
clasificar por tipo de comercio de Points Relais®.

Utilizando el filtro sobre el número del Punto Relais®, este método permite obtener información
sobre un Punto Relais® en particular.

Instrucciones y consejos de uso


Utilización de los criterios de localización
La búsqueda de la ubicación puede realizarse de diferentes 2maneras:

• A través del código postal de la ciudad + el código del país


• Mediante GPS (Latitud + Longitud)
Utilización del filtro " Typeactivite " (Tipo de comercio)
Los resultados del método pueden definirse para determinados tipos de comercio de Point Relais® (por
ejemplo, floristerías, etc.). Para utilizarlo, informe el parámetro opcional TipoActividad. Si desea
utilizar varios tipos de comercio en los parámetros, sepárelos con las comas " , ". Si el parámetro se
deja en blanco, obtendrá todos los tipos de comercio de Point Relais®. La lista de tipos de comercio
disponibles puede ser enviada a usted a petición.

Utilización del filtro "Rayonrecherche" (Radio de búsqueda)


Los resultados del método pueden limitarse desde el punto de origen de la búsqueda. Para ello,
mencione el parámetro opcional RayonRecherche con un valor en KM. Si el parámetro se deja en
blanco, el radio de búsqueda por defecto será de 50 Km. Si no desea utilizar este filtro, mencione 0
como valor del parámetro. Tenga en cuenta que este método nunca publicará más de 30 Point
Relais®.

Se aplica un radio de búsqueda máximo según el parámetro del tipo de acción:

• Acción = REL , Radio máximo = 75 Km


• Acción = 24R, Radio máximo = 100 Km
• Acción = 24L, Radio máximo = 100 Km
• Acción = DRI, , Radio máximo = 200 Km

Utilización del filtro " Acción "


Los resultados del método pueden limitarse en función del modo de entrega o recogida. Para ello,
mencione el parámetro Acción. Si el parámetro se deja en blanco, se utilizará el valor 24R por
defecto.

Los valores posibles son:

• 24R : Buscar los Puntos Relais que proponen la entrega a Punto Relais® L •
• 24L : Buscar los puntos Relais que proponen la entrega al Punto Relais® XL
• DRI : Buscar los puntos Relais que proponen la entrega a Colisdrive®.
• REL : Buscar los puntos Relais que sugieren la colección de Point Relais®.
Utilización del filtro " Délais d'envoi " (plazo de entrega)
Los resultados del método pueden adaptarse en función del tiempo necesario para realizar los
envíos a Mondial Relay. Basta con especificar el número de días en el parámetro " DelaisEnvoi ".

Utilización del filtro " Numéro de Point Relais® " (Número de Point Relais®)
Puede obtener información sobre un Punto Relais concreto especificando los parámetros " Pays "
(País) y " NumPointRelais " (Número de Punto Relais®).

Método WSI4_PointRelais_Recherche

En parámetros
(F) Facultativo /
Parámetros Comentar
(O) Obligatorio
io
8 Caracteres alfanuméricos
Enseigne (Comerciante) O
^[0-9A-Z]{2}[0-9A-Z ]{6}$
Su código de comerciante proporcionado por Mondial Relay en su documento
de parámetros de seguridad

2 Caracteres alfanuméricos
Pays (País) O
^[A-Za-z]{2}$
Código ISO del país a partir del cual se debe realizar la búsqueda

6 Caracteres alfanuméricos
NumPointRelais F/O
^[0-9]{6}$
Point Relais I D debe utilizarse en combinación con el parámetro país si se
desea obtener información particular de Point Relais®.

25 Caracteres alfanuméricos
Ville (Ciudad) F/O
^[A-Za-z_\-' ]{2,25}$
NO APLICABLE

Depende del país


CP (código postal) F/O

Código postal que se utilizará como origen de la búsqueda. Los resultados se


ordenarán por la distancia más cercana al código postal de búsqueda en orden
descendente. Este parámetro es opcional si se indica la ciudad, pero se aconseja
utilizar el código postal.

11 Personajes
Latitude F/O
^-?[0-9]{2}\.[0-9]{7}$
Latitud que se utilizará como origen de la búsqueda. Si se da este parámetro,
no se tendrá en cuenta el código postal.

11 Personajes
Longitude F/O
^-?[0-9]{2}\.[0-9]{7}$
Longitud que se utilizará como origen de la búsqueda. Si se da este parámetro,
no se tendrá en cuenta el código postal.

Lista de valores
Taille (Talla) F
^(XS|S|M|L|XL|3XL)$
No utilizar a menos que lo especifique Mondial Relay.
Poids (Peso) F

(F) Facultativo /
Parámetros Comentar
(O) Obligatorio
io
Peso del envío en gramos. (15 gramos como mínimo)
6 Caracteres numéricos
^[0-9]{1,6}$

Lista de valores
Action F
^(REL|24R|24L|DRI)$
Modo de recogida o entrega.

6 Caracteres numéricos
DelaiEnvoi F

Parámetro opcional que permite especificar el plazo de entrega: el tiempo ^-?[0-9]{2})$


necesario entre el pedido y el envío a Mondial Relay.
Cuando el servicio web se utiliza el día D con un número determinado de días
antes del envío del paquete (es decir, 28 días), el servicio web sólo proporciona
los Puntos Relais® que están abiertos el día D+28 días y que permanecerán
abiertos durante un día14 más, con el fin de dar al usuario final el tiempo
suficiente para recoger el paquete.
Un Points Relais® se considera abierto cuando no está de vacaciones o cerrado
excepcionalmente.
No diferenciamos entre días laborables abiertos y fines de semana.
4 Caracteres numéricos
RayonRecherche F
^[0-9]{1,4}$
Radio de búsqueda en Km desde un punto de origen de la búsqueda. Si no se
indica o está en blanco, el valor por defecto es de 50Km. Para no utilizar este
filtro "RayonRecherche" indique "0".

^(\d{3},|\d{3})*$
TypeActivitie F

Especifique el tipo de comercio para Point Relais®. Se pueden especificar varios


tipos de comercio, deben estar separados por " , " ".

NACE NA No aplicable

Numérico (máx. :
NombreResultats O
30) [0-3][0-9]
Define el número de Puntos Relais® devueltos en la respuesta

32 Caracteres alfanuméricos
SECURITY O
hash MD5 en mayúsculas para la siguiente cadena : ^[0-9A-Z]{32}$

[Enseigne][Pays][NumPointRelais][Ville][CP][Latitude][Longitude][Taille][Poids][
Action][DelaiEnvoi][RayonRecherche][TypeActivite][NombreResultats][CLE
PRIVEE]

La [CLE PRIVEE] (clave privada) se menciona en el documento de parámetros de


seguridad facilitado por Mondial Relay

Parámetros de salida

Parámetros (F) Opcional / (O) Comentar


Obligatorio io
3 Caracteres numéricos
STAT O
^[0-9]{1,3}$
El código de retorno de la solicitud es por0 defecto (0 si todo es correcto). Para
los demás códigos, consulte la lista de códigos de retorno.

Points Relais Tabla de datos

6 Caracteres numéricos
>Num O
^[0-9]{6}$
Punto Relais® ID

36 Caracteres alfanuméricos
>Lgdr1 O

Nombre de Point Relais® (Línea 1)

36 Caracteres alfanuméricos
>LgAdr2 O

Nombre de Point Relais® (Línea 2)

36 Caracteres alfanuméricos
>LgAdr3 O

Dirección de Point Relais® (Línea 1)

36 Caracteres alfanuméricos
>LgAdr4 O

Dirección de Point Relais® (Línea 2)

Depende del país


>CP O

Código postal de Point Relais

32 Caracteres alfanuméricos
>Ville O

Ciudad de Point Relais

2 Caracteres alfanuméricos
>Pays O

Código de país ISO de Point Relais


11 Personajes
>Latitude O
^-?[0-9]{2}\.[0-9]{7}$
Punto Relais® Latitud

11 Personajes
>Longitude O
^-?[0-9]{2}\.[0-9]{7}$
Punto Relais® Longitud

>TypeActivite O

Parámetros (F) Opcional / (O) Comentar


Obligatorio io

Tipo de comercio Point Relais

>Distancie O

Distancia en metros desde el origen de la búsqueda.

>Localisation1 O

Información adicional sobre la situación de Point Relais® (Línea 1)

>Localización2 O

Información adicional sobre la situación de Point Relais® (Línea 2)

Matriz de cadenas [4]


>Horaire_ Lundi O

Horario de apertura del lunes (Dato 1 : franja horaria de apertura 1), (Dato 2 :
franja horaria de cierre 1), (Dato 3 : franja horaria de apertura 2), (Dato : franja
horaria de 4cierre 2).

Matriz de cadenas [4]


>Horaire_ Mardi O

Horario de apertura del martes

Matriz de cadenas [4]


>Horaire_ Mercredi O

Horario de apertura del miércoles

Matriz de cadenas [4]


>Horaire_ Jeudi O

Horario de apertura del jueves

Matriz de cadenas [4]


>Horaire_ Vendredi O

Horario de apertura del viernes

Matriz de cadenas [4]


>Horaire_ Samedi O
Horario de apertura de los sábados

Matriz de cadenas [4]


>Horaire_ Dimanche O

Horario de apertura del domingo

Conjunto de objetos
>Informaciones_Dispo O

Información para el futuro periodo de vacaciones de Point Relais

>Debut O

Inicio de la fecha de cierre Fecha

Parámetros (F) Opcional / (O) Comentar


Obligatorio io

>Fin O

Fin de la fecha de cierre

>URL_Plan O

URL de la ubicación de Point Relais® en el mapa de Google

>URL_Photo O

URL de la foto de Point Relais

Búsqueda por código postal


Esta función permite tener una lista de comunidades y códigos postales con el nombre de la ciudad.

Método WSI2_RechercheCP

En parámetros
Facultativo /
Parámetro Obligatorio Comentario

8 fijar los caracteres


Enseigne (Comerciante) O
^[0-9A-Z]{2}[0-9A-Z ]{6}$
Este parámetro es el código de identificación del comerciante que figura en el
documento de parámetros.

Pays (País) O 2 fijar los caracteres

Código ISO del país a partir del cual se debe realizar la búsqueda Código ISO, para Francia :
FR
^[A-Z]{2}$
3 a los personajes26
Ville (Ciudad) O
Las letras iniciales de la ciudad para la búsqueda. [A-Z_-' ]{3,26}

Depende del país, en el


CP (código postal) F
caso de Francia:
Código postal de la ciudad para la búsqueda. 5 arreglar los caracteres
numéricos ^[0-9]{5}$

NbResult O
1 a los caracteres
Cantidad de resultados requeridos numéricos2
Máximo : 15
32 fijar los caracteres
Security O
^[0-9A-Z]{32}$
Código de seguridad.

Parámetros de salida
Facultativo /
Parámetros Obligatorio Comentario

3 caracteres numéricos
STAT O
^[0-9]{1,3}$
Estado de la llamada

Tabla de datos
Liste (Lista)

Tabla de comunidades

> CP (código postal) O

Código postal de la ciudad Depende del país, en el


caso de Francia:
5 arreglar los caracteres
numéricos ^[0-9]{5}$
32 caracteres
> Ville (Ciudad) O

Nombre de la ciudad

> Pays (País) O 2 fijar los caracteres

Código de país de la ciudad Código ISO, para Francia :


FR
^[A-Z]{2}$
Creación de envíos
Este método crea un envío en el sistema de Mondial Relay y devuelve los datos para construir un envío
personalizado etiquetas.

Formato de los números de teléfono :


• FR : "((" + "\+33" + "[1-9][0-9]{8}"+")"
• BE (fixes) : + "|(" + "\\+32" + "[0-9]{8}"+")"
• BE (portables) : + "|(" + "\\+32" + "[4][0-9]{8}"+")"
• LU : + "|(" + "\\\+352" + "[0-9]{6,10}"+")"
• PT : + "|(" + "\\+351" + "[0-9]{9}"+ ")"
• ES (fixes) : + "|(" + "\\+34" + "9[0-9]{8}"+")"
• ES (portables) : + "|(" + "\\+34" + "6[0-9]{8}"+ ")"
• DE : + "|(" + "\\+49" + "[0-9]{10,11}"+")"
• IT : + "|(" + "\\+39" + "[0-9]{10}"+ ")"
• Mónaco : + "|(" + "\\+377" + "[0-9]{5}"+")"
Formato de los códigos postales

• DE : [0-9]{5}
• BE : [0-9]{4}
• ES : [0-9]{5}
• FR : [0-9]{5}
• IT : [0-9]{5}
• LU : [0-9]{4}
• PT : [0-9]{4}(-[0-9]{3})?
• GB : (¿1,2?)\Nde [\Nde] 0,2}[ ]\Nde [\Nde]\N2}
• ES DECIR : [0-9A-Z ]{0,10}
• NL : [0-9 A-Z]{4,7}
• AT : [0-9]{4}

Método WSI2_CreationExpedition
En parámetros
Parámetros Facultativo / Comentar
Obligatorio io

8 fijar los caracteres


Enseigne (Comerciante) O
^[0-9A-Z]{2}[0-9A-Z ]{6}$
Este parámetro es el código de identificación del comerciante que figura en
el documento de parámetros.

Lista de valores predefinidos


ModeCol O
^(CCC|CDR|CDS|REL)$
Modo de recogida

Lista de valores predefinidos


ModeLiv O
Modo de entrega ^(LCC|LD1|LDS|24R|24L|ESP|DRI)$

15 caracteres
NDossier F
^(|[0-9A-Z_ -]{0,15})$
Referencia del envío del comerciante, por ejemplo, número de factura.

9 caracteres
NClient F
^(|[0-9A-Z]{0,9})$
Referencia del destinatario (n°)

Expe_Langage O 2 fijar los caracteres

Idioma del cargador Código ISO, para los franceses: FR


^[A-Z]{2}$

32 caracteres
Expe_Ad1 O
^[0-9A-Z_\-'., /]{2,32}$
Remitente (Datos Nombre Nombre)
Datos aceptados = "MR", "M.", "MME", "MLE" y "MLLE

Parámetros Facultativo / Comentar


Obligatorio io

Particulares :
^((MR|M.|M|MME|MLE|MLLE) )$

32 caracteres
Expe_Ad2 F
^[0-9A-Z_\-'., /]{0,32}$
Remitente (información adicional de la dirección)

32 caracteres
Expe_Ad3 O
^[0-9A-Z_\-'., /]{2,32}$
Remitente (calle)
En los Países Bajos, el número de la calle debe aparecer al final del campo

32 caracteres
Expe_Ad4 F
^[0-9A-Z_\-'., /]{0,32}$
Remitente (información adicional de la dirección)

Depende del país, en el caso de


Expe_Ville O
Francia
Remitente (ciudad) : personajes26
^[A-Z_-' ]{2,26}$

Depende del país, en el caso de


Expe_CP O
Francia
Remitente (código postal) : fijar5 los caracteres numéricos
^[0-9@]{1}[0-9]{4}$
Expe_Pays O 2 fijar los caracteres
Remitente (código de país) (código ISO : FR, BE...) Código ISO de Francia: FR
^[A-Z]{2}$

Depende del país, en el caso de


Expe_Tel1 O
Francia
Remitente (número de teléfono) : caracteres numéricos13
^((00|\+)33|0)[0-9][0-9]{8}$

Depende del país, en el caso de


Expe_Tel2 F
Francia
Remitente (Nº de celda) :13 caracteres numéricos
^((00|\+)33|0)[0-9][0-9]{8}$

70 caracteres
Expe_Mail F
Formato de correo electrónico
Remitente (correo electrónico) RFC2822
^[\w\-\.\@_]{7,70}$

Dest_Langage O 2 fijar los caracteres


Lengua del destinatario Códigos de condado ISO
permitidos: FR, ES, NL, EN
^[A-Z]{2}$

Dest_Ad1 O

Parámetros Facultativo / Comentar


Obligatorio io

Destinatario (Datos Nombre Nombre)


32 caracteres
Datos aceptados = "MR", "M.", "MME", "MLE" y "MLLE ^[0-9A-Z_\-'., /]{2,32}$
Particulares :
^((MR|M.|M|MME|MLE|MLLE) )$

32 caracteres
Dest_Ad2 F
^[0-9A-Z_\-'., /]{0,32}$
Destinatario (información adicional de la dirección)

32 caracteres
Dest_Ad3 O
^[0-9A-Z_\-'., /]{2,32}$
Destinatario (Calle)
En los Países Bajos, el número de la calle debe aparecer al final del campo

32 caracteres
Dest_Ad4 F
^[0-9A-Z_\-'., /]{0,32}$
Destinatario (información adicional de la dirección)

Depende del país, en el caso de


Dest_Ville O
Destinatario (Ciudad) Francia
: personajes26
^[A-Z_-' ]{2,26}$
Depende del país, en el caso de
Dest_CP O
Francia
Destinatario (código postal) :
5 arreglar los caracteres numéricos
^[0-9@]{1}[0-9]{4}$

2 caracteres fijos
Dest_Pays O
ISO,código de Francia :
Destinatario (código de país) (código ISO : FR, BE...)
FR
^[A-Z]{2}$

Depende del país, en el caso de


Dest_Tel1 O/F
Francia
Destinatario (número de teléfono), obligatorio para la entrega a domicilio : caracteres numéricos13
^((00|\+)33|0)[0-9][0-9]{8}$

Depende del país, en el caso de


Dest_Tel2 F
Francia
Destinatario (número de móvil) : caracteres numéricos13
^((00|\+)33|0)[0-9][0-9]{8}$

70 caracteres
Dest_Mail F
Formato de correo electrónico
Destinatario (correo electrónico) RFC2822
^[\w\-\.\@_]{7,70}$

Poids (Peso) O

Parámetros Facultativo / Comentar


Obligatorio io

Peso en gramos (15 gramos como mínimo)


7 dígitos numéricos +
decimales opcionales2 ^[0-
9]{3,7}\.?[0-9]{0,2}$

3 caracteres numéricos
Longueur (Longitud) F
^[0-9]{0,3}$
Longitud desarrollada en cm.

Lista de valores predefinidos


Taille (Talla) F
^(XS|S|M|L|XL|3XL)$
A menos que sea notificado por Mondial Relay, por favor deje esta zona en
blanco.
2 caracteres numéricos
NbColis O
Cantidad de paquetes en el envío ^[0-9]{1,2}$

7 caracteres numéricos
CRT_Valeur (valor COD) O
^[0-9]{1,7}$
Valor del envío contra reembolso en céntimos

Lista de valores predefinidos


CRT_Devise (moneda COD) F
^(|EUR)$
" EUR " por defecto.

7 caracteres numéricos
Exp_Valeur (valor del envío) F
^[0-9]{0,7}$
Valor del envío en céntimos

Lista de valores predefinidos


Exp_Devise (moneda de envío) F
^(|EUR)$
" EUR " por defecto.

2 caracteres fijos (código ISO del


COL_Rel_Pays O/F
país)
Obligatorio si se recoge en Point Relais ^[A-Z]{2}$
Rellene " XX " y el país será
reconocido automáticamente con
respecto a la dirección del remitente

6 caracteres numéricos fijos


COL_Rel O/F
(Point Relais® ID)
Obligatorio si se recoge en Point Relais Rellene " AUTO " para seleccionar
automáticamente el Point Relais®
más cercano con respecto al código
postal del remitente

LIV_Rel_Pays O/F 2 fijar los caracteres

Obligatorio si se entrega en Point Relais Código ISO, para Francia : FR


^[A-Z]{2}$

Parámetros Facultativo / Comentar


Obligatorio io

6 caracteres numéricos fijos


LIV_Rel O/F
^(|[0-9]{6})$
Obligatorio si se entrega en Point Relais

Lista de valores predefinidos


Tavisage (notificación) F
Solicitud de notificación de envío. ^(|O|N)$
" O" para "Sí" y "N" para "No"

Advertencia: el proceso de notificación de Mondial Relay puede ir más allá


de una simple solicitud. Póngase en contacto con Mondial Relay para
conocer el proceso de notificación estándar. Si no utiliza el proceso de
notificación, deje esta zona vacía.

Lista de valores predefinidos


TReprise F
^(|O|N)$
" O" de "Sí"
" N" de "No"
" N " por defecto.

3 caracteres numéricos
Montage F
^(|[0-9]{1,3})$
Tiempo de montaje
" 0 " por defecto.

Lista de valores predefinidos


TRDV F
^(|O|N)$
Solicitud de cita de entrega :
" O" para "Sí" y "N" para "No"
" N " por defecto

Advertencia : Por favor, deje esta zona vacía. No utilizamos esta


información.

1 carácter
Assurance F
^(|[0-9A-Z]{1})$
Cobertura del seguro. "
0 " por defecto.

Póngase en contacto con Mondial Relay para conocer las diferentes


coberturas de seguro disponibles.

31 caracteres
Instrucciones F
^[0-9A-Z_\-'., /]{0,31}
Información adicional

32 fijar los caracteres


Seguridad O
^[0-9A-Z]{32}$
Código de seguridad

Parámetros de salida
Parámetros Facultativo / Comentario
Obligatorio

3 caracteres numéricos
STAT O
Estado de la llamada ^[0-9]{1,3}$

8 arreglar los caracteres


ExpediciónNum O
numéricos ^[0-9]{8}$
Número de envío de Mondial Relay

4 arreglar los caracteres


TRI_AgenceCode O
numéricos ^[0-9]{4}$
Código de la agencia

3 fijar los caracteres


TRI_Groupe O
^[A-Z][0-9]{2}$
Número de grupo de clasificación

6 arreglar los caracteres


TRI_Navette O
numéricos ^[0-9]{6}$
Número de la carrera del transbordador

30 caracteres
TRI_Agence O

Nombre de la agencia

5 arreglar los caracteres


TRI_TourneeCode O
numéricos ^[0-9]{5}$
Ejecución de la entrega

Lista de valores
TRI_LivraisonMode O
predefinidos
Modo de entrega ^(LCC|LD1|LDS|24R|24L
|ESP|DRI)$

CodesBarres O
Tabla de caracteres de
Tabla de códigos de barras
cadena Formato de cada
elemento :
26 arreglar los
caracteres numéricos
^[0-9]{26}$
N.B:

Las especificaciones de las etiquetas están disponibles en línea


(https://www.mondialrelay.fr/solutionspro/documentation- technique/cahier-des-
chargesinformatiques/). Consulte este documento para aplicar las etiquetas.
Tenga en cuenta que Mondial Relay debe validar sus etiquetas antes de cualquier Go Live.
Creación de etiquetas
Método WSI2_CreationEtiquette
Este método espera los mismos parámetros internos que WSI2_CreationExpedition pero devuelve
directamente una etiqueta PDL.

En parámetros
Facultativo /
Parámetros Obligatorio Comentar
io
8 fijar los caracteres
Enseigne O
^[0-9A-Z]{2}[0-9A-Z ]{6}$
Este parámetro es el código de identificación del comerciante que figura
en el documento de parámetros.

Lista de valores predefinidos


ModoCol O
^(CCC|CDR|CDS|REL)$
Modo de recogida

Lista de valores predefinidos


ModeLiv O
^(LCC|LD1|LDS|24R|24L|ESP|DRI)$
Modo de entrega

15 caracteres
NDossier F
^(|[0-9A-Z_ -]{0,15})$
Referencia del envío del comerciante, por ejemplo, número de factura

9 caracteres
NClient F
^(|[0-9A-Z]{0,9})$
Referencia del destinatario

Expe_Langage O 2 fijar los caracteres


Idioma del remitente Código ISO, para el francés : FR
^[A-Z]{2}$

Expe_Ad1 O 32 caracteres

Remitente (datos Nombre Nombre) ^[0-9A-Z_\-'., /]{2,32}$


Datos aceptados = "MR", "M.", "MME", "MLE" y "MLLE Particulares :
^((MR|M.|M|MME|MLE|MLLE) )$

32 caracteres
Expe_Ad2 F
^[0-9A-Z_\-'., /]{0,32}$
Remitente (Otra información del nombre)

32 caracteres
Expe_Ad3 O
^[0-9A-Z_\-'., /]{2,32}$
Remitente (Calle)
En los Países Bajos, el número de la calle debe aparecer al final del campo

Expe_Ad4 F
Facultativo /
Parámetros Obligatorio Comentar
io
Remitente (información adicional de la dirección)
32 caracteres
^[0-9A-Z_\-'., /]{0,32}$

Expe_Ville O Depende del país, en el caso de


Remitente (ciudad) Francia : personajes26
^[A-Z_-' ]{2,26}$

Depende del país, en el caso de


Expe_CP O
Francia: fijar5 los caracteres
Remitente (código postal)
numéricos
^[0-9@]{1}[0-9]{4}$

Expe_Pays O 2 fijar los caracteres


Remitente (código de país) (código ISO : FR, BE...) Código ISO, para Francia : FR
^[A-Z]{2}$

Depende del país, para Francia:


Expe_Tel1 O
caracteres numéricos13
Remitente (número de teléfono)
^((00|\+)33|0)[0-9][0-9]{8}$

Expe_Tel2 F El formato depende del país, para


Francia :
Remitente (número de móvil)
13 caracteres numéricos
^((00|\+)33|0)[0-9][0-9]{8}$

70 caracteres
Expe_Mail F
Formato de correo electrónico
Remitente (correo electrónico)
RFC2822
^[\w\-\.\@_]{7,70}$

Dest_Langage O
2 fijar los caracteres
Idioma del remitente Códigos de condado ISO permitidos:
FR, ES, NL, ES
^[A-Z]{2}$

Dest_Ad1 O 32 caracteres
Destinatario (Datos Nombre Nombre) ^[0-9A-Z_\-'., /]{2,32}$

Datos aceptados = "MR", "M.", "MME", "MLE" y "MLLE Particulares :


^((MR|M.|M|MME|MLE|MLLE) )$

32 caracteres
Dest_Ad2 F
Destinatario (Otra información del nombre) ^[0-9A-Z_\-'., /]{0,32}$

Facultativo /
Parámetros Obligatorio Comentar
io
32 caracteres
Dest_Ad3 O
^[0-9A-Z_\-'., /]{2,32}$
Destinatario (Calle)
En los Países Bajos, el número de la calle debe aparecer al final del campo

32 caracteres
Dest_Ad4 F
^[0-9A-Z_\-'., /]{0,32}$
Destinatario (Información adicional de la dirección)

Dest_Ville O Depende del país, en el caso de


Destinatario (Ciudad) Francia : personajes26
^[A-Z_-' ]{2,26}$

Dest_CP O Depende del país, en el caso de

Destinatario (código postal) Francia: fijar5 los caracteres


numéricos
^[0-9@]{1}[0-9]{4}$

Dest_Pays O 2 fijar los caracteres


Destinatario (código de país) (código ISO : FR, BE...) Código ISO, para Francia : FR
^[A-Z]{2}$

Dest_Tel1 O/F Depende del país, para Francia:


Destinatario (número de teléfono), obligatorio para la entrega a domicilio caracteres numéricos13
^((00|\+)33|0)[0-9][0-9]{8}$

Dest_Tel2 F Depende del país, para Francia:


Destinatario (teléfono móvil) caracteres numéricos13
^((00|\+)33|0)[0-9][0-9]{8}$

70 caracteres
Dest_Mail F
Formato de correo electrónico
Destinatario (correo electrónico) RFC2822
^[\w\-\.\@_]{7,70}$

Poids O 7 dígitos numéricos +


Peso en gramos (15 gramos como mínimo) decimales opcionales2 ^[0-
9]{3,7}\.?[0-9]{0,2}$

3 caracteres numéricos
Longueur F
Longitud desarrollada en cm ^[0-9]{0,3}$

Lista de valores predefinidos


Taille F
^(XS|S|M|L|XL|3XL)$
A menos que Mondial Relay indique lo contrario, deje este campo vacío.

Facultativo /
Parámetros Obligatorio Comentar
io
2 caracteres numéricos
NbColis O
^[0-9]{1,2}$
Número de paquetes en el envío

7 caracteres numéricos
CRT_Valeur O
^[0-9]{1,7}$
Valor del envío contra reembolso en céntimos

Lista de valores predefinidos


CRT_Devise F
^(|EUR)$
Moneda del valor COD, " EUR " por defecto

7 caracteres numéricos
Exp_Valeur F
^[0-9]{0,7}$
Valor del envío en céntimos

Lista de valores predefinidos


Exp_Devise F
^(|EUR)$
Moneda del valor del envío, " EUR " por defecto

2 caracteres fijos (código ISO del


COL_Rel_Pays O/F
país)
Obligatorio si se recoge en Point Relais®. ^[A-Z]{2}$
Rellene " XX " y el país será reconocido
automáticamente con
respecto a la dirección del remitente

6 caracteres numéricos fijos (Point


COL_Rel O/F
Relais® ID)
Obligatorio si se recoge en Point Relais®. Rellene " AUTO " para seleccionar
automáticamente el Point Relais® más
cercano con respecto al código postal
del remitente

LIV_Rel_Pays O/F 2 fijar los caracteres


Obligatorio si se entrega en Point Relais®. Código ISO, para Francia : FR
^[A-Z]{2}$

6 arreglar los caracteres numéricos


LIV_Rel O/F
Obligatorio si se entrega en Point Relais®. ^(|[0-9]{6})$

Lista de valores predefinidos


TAvisage F
^(|O|N)$
Solicitud de notificación para este envío.
" O" para "Sí" y "N" para "No"

Advertencia: el proceso de notificación de Mondial Relay puede ir más


allá de una simple solicitud. Por favor, póngase en contacto con Mondial
Relay para conocer la notificación estándar

Facultativo /
Parámetros Obligatorio Comentar
io
proceso. Si no le preocupa el proceso de notificación, deje esta zona
vacía.

Lista de valores predefinidos


TReprise F
^(|O|N)$
" O" para "Sí" y "N" para "No" "
N " por defecto.

3 caracteres numéricos
Montaje F
^(|[0-9]{1,3})$
Tiempo de montaje "
0 " por defecto.

Lista de valores predefinidos


TRDV F
^(|O|N)$
Solicitud de cita para la entrega :
" O" para "Sí" y "N" para "No"
" N " por defecto

Advertencia : Por favor, deje esta zona vacía. No utilizamos esta


información.
1 carácter
Assurance F
^(|[0-9A-Z]{1})$
Cobertura del seguro.
" 0 " por defecto.
Póngase en contacto con Mondial Relay para conocer las diferentes
coberturas de seguro disponibles.

31 caracteres
Instructions F
^[0-9A-Z_\-'., /]{0,31}
Información adicional

32 fijar los caracteres


Security O
^[0-9A-Z]{32}$
Código de seguridad

336 caracteres
Texte F
10 x caracteres30 separados por " (cr) " ^([^<>&']{3,30})(\(cr\)[^<>&']{0,30}){0
,9}$
ADVERTENCIA: No se tiene en cuenta para el cálculo de la clave de
seguridad.

El campo "Texte" corresponde a los artículos que componen el envío, este campo estará presente en la
segunda parte de la etiqueta. Este campo no puede tener los siguientes caracteres & ''" < y >.

Este campo puede tener un máximo de 10 líneas de hasta 30 caracteres. Cada línea corresponde a
un artículo. Cada final de línea se traducirá en el campo de texto por los caracteres de cadena "
(cr) ".
Esta cadena de caracteres permitirá el retroceso al margen durante la impresión. En caso de que el
campo de texto tenga más de 10 líneas, éstas se eliminarán durante la impresión.

Este texto sólo aparece en las etiquetas A4 y A5 (no en las de 10x15).

Parámetros de salida
Facultativo /
Parámetros Obligatorio Comentario

3 caracteres numéricos
STAT O
^[0-9]{1,3}$
Estado de la llamada

8 arreglar los caracteres


ExpeditionNum O
numéricos ^[0-9]{8}$
Número de envío de Mondial Relay

URL_Etiquette O

Etiquetar la URL del PDF

El valor dado por URL_Etiquette no incluye el nombre de dominio ni el protocolo. Tras

la reconstitución del enlace completo, la URL del PDF debe tener el siguiente aspecto:
http://www.mondialrelay.com/ww2/PDF/StickerMaker2.aspx?ens=BDTEST 11&expedition=171697
84&lg=FR&format=A4&crc=FF6273F49A0CCF4C4E058D8F904C618F

Puede elegir el formato de la etiqueta mencionando el valor A5 o 10x15 en lugar de A4 en el


parámetro URL " formato ".
Seguimiento de paquetes
Método WSI2_TracingColisDetaille

En parámetros
Parámetros Facultativo / Comentario
Obligatorio

8 fijar los caracteres


Enseigne O
^[0-9A-Z]{2}[0-9A-Z ]{6}$
Este parámetro es el código de identificación del comerciante que figura en el
documento de parámetros.

8 arreglar los caracteres


Expedition O
numéricos ^[0-9]{8}$
Número de envío

Langue O

Idioma solicitado para el seguimiento 2 fijar los caracteres


Código ISO, para el
francés : FR ^[A-Z]{2}$
Parámetros Facultativo / Comentario
Obligatorio

32 fijar los caracteres


Security O
^[0-9A-Z]{32}$
Código de seguridad.

Parámetros de salida
Facultativo /
Parámetros Obligatorio Comentario

3 caracteres numéricos
STAT O

Estado de la llamada ^[0-9]{1,3}$

Libelle01 O

Relais_Libelle F

Nombre de Point Relais® (si es necesario)

6 arreglar los caracteres


Relais_Num F
Número de Point Relais® (si es necesario) numéricos

^[0-9]{6}$

Libelle02 O

Array
Tracing O

Tabla de seguimiento

> Tracing_Libelle F

Nombre de seguimiento

> Tracing_Date F

Fecha de seguimiento

> Tracing_Heure F

Hora de seguimiento

> Tracing_Lieu F

Lugar de seguimiento (ciudad)

Facultativo /
Parámetros Obligatorio Comentario

6 arreglar los caracteres


> Tracing_Relais F
numéricos
Número de seguimiento de Point Relais (si es necesario)
^[0-9]{6}$
2 fijar los caracteres
> Tracing_Pays F

País de seguimiento de Point Relais® (si es necesario) ^[A-Z]{2}$


Recuperación de etiquetas concatenadas
Método WSI3_GetEtiquettes
Este método permite recuperar varias etiquetas con una única llamada al Servicio Web.

En Parámetros
Facultativo /
Parámetros Obligatorio Comentario

8 caracteres de cfix
Enseigne O
^[0-9A-Z]{2}[0-9A-Z ]{6}$
Este parámetro es el código de identificación del comerciante que figura en el
documento de parámetros.
8 arreglar los caracteres
Expeditions O
numéricos
Los números de los envíos deben figurar en el documento PDF. ^[0-9]{8}(;[0-9]{8})*$

Langue O 2 fijar los caracteres

Se ha pedido que se incluya un texto en las etiquetas. Código ISO, para el francés :
FR
^[A-Z]{2}$
32 fijar los caracteres
Security O
^[0-9A-Z]{32}$
Código de seguridad.

Parámetros de salida
Facultativo /
Parámetros Obligatorio Comentario

3 caracteres numéricos
STAT O

Estado de la llamada ^[0-9]{1,3}$

URL_PDF_A4 O

URL del PDF, etiquetas en formato A4

Facultativo /
Parámetros Obligatorio Comentario

URL_PDF_A5 O

URL del PDF, etiquetas en formato A5

URL_PDF_10x15 O

URL del PDF, etiquetas en formato 10x15


Lista de códigos de estado
Método WSI2_STAT_Label

En parámetros
Facultativo /
Parámetros Obligatorio Comentario

8 fijar los caracteres


Enseigne O
^[0-9A-Z]{2}[0-9A-Z ]{6}$
Este parámetro es el código de identificación del comerciante que figura en el
documento de parámetros.
3 caracteres numéricos
STAT_ID O
^[0-9]{1,3}$
Número de estado

2 fijar los caracteres


Langue O
Código ISO, para el francés :
Idioma solicitado para el nombre FR
Sólo en francés por el momento.
^[A-Z]{2}$

32 caracteres de la oficina
Security O
^[0-9A-Z]{32}$
Código de seguridad.

Parámetros de salida
Parámetros Facultativo /
Obligatorio Comentario

Chaîne texte 150 caracteres


O

Nombre
Códigos de estado
Cada respuesta a una solicitud de servicio web da un código de estado

para esta solicitud. Estos códigos de estado son numéricos y normalmente

de 2 dígitos.

La siguiente lista ofrece la relación entre el código y el nombre del error para la corrección de la

disfunción. Tenga en cuenta que el código de respuesta " 0 " indica que la solicitud es correcta y se ha

recibido con éxito.

Sin embargo, algunas solicitudes como las de seguimiento no dan "0", sino que se publican otros
códigos de estado del envío.

Código de Descripción
estado

0 Operación exitosa

1 Comerciante incorrecto

2 Número de comerciante vacío

3 Número de cuenta comercial incorrecto

5 Referencia incorrecta del envío del comerciante

7 Referencia incorrecta del destinatario (campo NCLIENT)

8 Contraseña o hash incorrecto

9 Ciudad desconocida o no única

10 Tipo de recogida incorrecto

11 El número de la colección Point Relais® es incorrecto

12 Colección Point Relais® country.incorrect

13 Tipo de entrega incorrecto

14 Número incorrecto del Punto Relais® de entrega

15 Punto de entrega de Relais país.incorrecto

16
17

18

19

Código de Descripción
estado

20 Peso del paquete incorrecto

21 Longitud desarrollada incorrecta (longitud + altura)

22 Tamaño de parcela incorrecto

23

24 Número de envío incorrecto

25

26 Tiempo de montaje incorrecto

27 Modo de recogida o entrega incorrecto

28 Modo de recogida incorrecto

29 Modo de entrega incorrecto

30 Dirección incorrecta (L1)

31 Dirección incorrecta (L2)

32

33 Dirección incorrecta (L3)

34 Dirección incorrecta (L4)

35 Ciudad incorrecta

36 Código postal incorrecto

37 País incorrecto

38 Número de teléfono incorrecto

39 Correo electrónico incorrecto

40 Parámetros que faltan


41

42 Valor incorrecto de la DQO

43 Moneda incorrecta en el pago de la factura

44 Valor de envío incorrecto

45 Moneda de valor de envío incorrecta

46 Fin del rango de números de envíos alcanzado

Código de Descripción
estado

47 Número incorrecto de parcelas

48 No se permite la multiplicidad de parcelas en Point Relais®.

49 Acción incorrecta

50

51

52

53

54

55

56

57

58

59

60 Campo de texto incorrecto (este código de error no tiene impacto)

61 Solicitud de notificación incorrecta

62 Información adicional incorrecta sobre la entrega

63 Seguro incorrecto

64 Tiempo de montaje incorrecto


65 Nombramiento incorrecto

66 Retorno incorrecto

67 Latitud incorrecta

68 Longitud incorrecta

69 Código comercial incorrecto

70 Número de Point Relais® incorrecto

71 Incorrecta Naturaleza del punto de venta no valido

72

73

Código de Descripción
estado

74 Lenguaje incorrecto

75

76

77

78 País de recogida incorrecto

79 País de entrega incorrecto

80 Código de seguimiento : Paquete registrado

81 Código de seguimiento : Paquete en proceso en Mondial Relay

82 Código de seguimiento : Paquete entregado

83 Código de seguimiento : Anomalía

84 (Código de seguimiento reservado)

85 (Código de seguimiento reservado)

86 (Código de seguimiento reservado)

87 (Código de seguimiento reservado)

88 (Código de seguimiento reservado)


89 (Código de seguimiento reservado)

90

91

92
El código de país de Point Relais® y el código de país del destinatario son diferentes.
O
Insuficiencia de fondos (cuentas prepagadas)

93
El plan de clasificación no proporciona ninguna información.
Si desea realizar una recogida o entrega en Point Relais, compruebe que está disponible.
Si quiere hacer una entrega a domicilio, compruebe si el código postal existe.

94 Parcela desconocida

95 Cuenta comercial no activada

96

97 Clave de seguridad incorrecta

Código de Descripción
estado

Cf. : § "Generación de la clave de seguridad"

98
Error genérico (Parámetros incorrectos)
Este error oculta otro error de la lista y sólo puede ocurrir en modo de producción. Cf.
: § " Funcionamiento normal y depuración "

99
Error genérico del sistema de servicio
Este error puede ocurrir debido a un problema de servicio técnico.
Por favor, notifique este error a Mondial Relay con la fecha y la hora de la solicitud, así como los
parámetros enviados con el fin de verificar
Código de estado del proceso de depuración 97 :

Como el hash MD5 sigue una concatenación de cadenas, aumentaremos gradualmente el tamaño
de la cadena alimentándola con un campo tras otro.

• Así que en la primera consulta sólo hay que rellenar los dos campos "Enseigne" y "Security"
• Si el estado de la solicitud es diferente de todo97, está bien.
• Añade el siguiente campo y envía la nueva solicitud.
• Si el estado de la solicitud es diferente de todo97, está bien.
• Y volvemos a empezar hasta que el estado de la consulta sea 97.
• En este caso, encontramos el campo con el error.
• Tal vez el valor del campo es mal interpretado para el hash MD5 (mayor de 126 caracteres
en la página de códigos).
• Puede que el nombre del campo esté mal escrito. Puede faltar una letra, por ejemplo. N.B.:

Hay que respetar el orden exacto de los parámetros


Ejemplos de códigos
Los siguientes ejemplos de códigos pueden ser utilizados como ejemplos y pueden ser utilizados
libremente. Si quiere contribuir a la lista de idiomas disponibles y a las diferentes formas de
contactar con los servicios web de Mondial Relay, envíe sus ejemplos de código fuente a:
servicesupport@mondialrelay.fr

Lenguaje C#
Función de generación de Hash MD5 (Message Digest
5)
public static string GetMd5(string Args)
{
string resultat = "";
System.Security.Cryptography.MD5CryptoServiceProvider
MD5_Provider = new
System.Security.Cryptography.MD5CryptoServiceProvider(); byte[]
buffer = System.Text.Encoding.Default.GetBytes(Args); buffer =
MD5_Provider.ComputeHash(buffer); foreach (byte b in buffer) {
resultat += b.ToString("X2"); } return resultat;
}

Función de generación de Hash SHA1 (Secure Hash Algorithm)


public static string GetSHA1(string Args)
{
string resultat = "";
System.Security.Cryptography.SHA1CryptoServiceProvider SHA1_Provider =
new System.Security.Cryptography.SHA1CryptoServiceProvider(); byte[]
buffer = System.Text.Encoding.ASCII.GetBytes(Args); buffer =
SHA1_Provider.ComputeHash(buffer); foreach (byte b in buffer) { resultat
+= b.ToString("X2"); } return resultat;
}

Método de solicitud " WSI4_PointRelais_Recherche " al WebService con Visual Studio


En el explorador de soluciones, haga clic con el botón derecho en el nombre del proyecto.
Seleccione "Referencias", "Añadir una referencia" o "Añadir una referencia web".

Cuando obtenga el cuadro de diálogo "Añadir una referencia web", mencione la URL del servicio
Mondial Relay en la zona de direcciones, valide.

Los métodos de Relé Mondial se publican en la parte izquierda del cuadro de diálogo.

Elija un nombre para la referencia web, por ejemplo: "WS_MondialRelay" y luego haga clic en "Añadir la
referencia".

WS_MondialRelay.Web_Services WS_MR = new WS_MondialRelay.Web_Services(); string


Clef_Securite = GetMd5(
"BDTEST12" // Enseigne
+ "FR"
+ ""
+ ""
+ "59000"
+ ""
+ ""
+ ""
+ ""
+ ""
+ ""
+ ""
+ ""
+ ""
+ ""
+ "Mot_de_passe" // Clé privée
);
WS_MondialRelay.ret_WSI4_PointRelais_Recherche WS_Retour =
WS_MR.WSI4_PointRelais_Recherche(
"BDTEST12", // Enseigne
"FR",
"",
"",
"59000",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
Clef_Securite // Hash MD5
);
if (WS_Retour.STAT == "0") { /* Traitement normal */ } else { /* Traitement des erreurs */ }
Lenguaje PHP
Método de solicitud " WSI4_PointRelais_Recherche " al Servicio Web con nuSOAP
Uno de los métodos más sencillos para utilizar un servicio web en PHP es el uso de la biblioteca " nuSOAP
":
" nuSOAP " es una biblioteca PHP gratuita

Este código de ejemplo realiza una búsqueda de Puntos Relais® (modo de entrega 24R) en un radio
de 20Km en Francia, alrededor del código postal 75010 en el que se puede definir el tipo de
comercio

<?php
require_once('lib/nusoap.php');

// Definición de la configuración global


// Definición de los parámetros globales
$MR_WebSiteId = "BDTEST12";
$MR_WebSiteKey = "MRT_2012";

$client = new nusoap_client("http://api.mondialrelay.com/Web_Services.asmx?WSDL", true);


$client->soap_defencoding = 'utf-8';

// Definimos los parámetros como un array de cadenas. Cada Key/Val representa un parámetro de la
llamada al jabón
// Se definen los parámetros en una tabla de cadenas. Cada par Clé/Valeur es un parámetro de la aplicación
SOAP
$params = array(
'Enseigne' => $MR_ WebSiteId,
'Pays' => "FR",
//'NumPointRelais' => "",
'Ville' => "",
'CP' => "75010", 'Latitud'
=> "",
'Longitud' => "",
'Taille' => "", 'Poids'
=> "",
'Acción' => "",
'DelaiEnvoi' => "0",
'RayonRecherche' => "20",
//'TypeActivite' => "",
//'NACE' => "",
'NombreResultats' => "20",
);
// Generamos el código de seguridad de la petición
// Se genera la clave de seguridad de la apelación
$code = implode("", $params);
$code .= $MR_WebSiteKey;
$params["Seguridad"] = strtoupper(md5($code));
// Hacemos la llamada y la cargamos en el var $resultado
// Se realiza la solicitud y se almacena el resultado en la variable $resultado
$resultado = $client->call(
"WSI4_PointRelais_Recherche",
$params,
'http://api.mondialrelay.com/',
'http://api.mondialrelay.com/WSI4_PointRelais_Recherche'
);
// Comprobamos que no haya ningún error durante el proceso
// Se comprueba que no hay ningún error
si ($cliente->fallo)
{
echo '<h2>Fallo (Expect - The request contains an invalid SOAP body)</h2><pre>';
print_r($result);

echo '</pre>';
}

si

no
{ $err = $client->getError(); if ($err) { echo
'<h2>Error</h2><pre>' . $err . '</pre>'; } else
{
echo
'<h2>Resultado</h2><pre>';
print_r($resultado); echo
'</pre>';
}
}
echo '<h2>Solicitud</h2><pre>' . htmlspecialchars($client->request, ENT_QUOTES) . '</pre>'; echo
'<h2>Respuesta</h2><pre>' . htmlspecialchars($client->response, ENT_QUOTES) .
'</pre>'; echo '<h2>Debug</h2><pre>' . htmlspecialchars($client->getDebug(), ENT_QUOTES) .
'</pre>';
?>
Lenguaje ASP3
Método de solicitud " WSI4_PointRelais_Recherche " al WebService con Msxml2
<!--#include virtual = "/md5.asp"-->
<% dim requestXML dim sParams dim security set requestXML =
Server.CreateObject("Msxml2.XMLHTTP") requestXML.Open "post",
"http://api.mondialrelay.com/Web_Services.asmx"

,false Definición' de la entrada SOAP/ XML estándar requestXML.setRequestHeader


"Content-Type", "text/xml" requestXML.setRequestHeader "MessageType", "CALL"

' Generación de hachas de seguridad security =


Ucase(md5("BDTEST12FR75010MRT_2012 "))

sParams = _
"<?xml version=""1.0"" encoding=""utf-8""?><soap12:Envelope
xmlns:xsi=""http://www.w3.org/2001/XMLSchema-instance""
xmlns:xsd=""http://www.w3.org/2001/XMLSchema""
xmlns:soap12=""http://www.w3.org/2003/05/soap-envelope"">" &_
"<soap12:Body>" &_
"<WSI4_PointRelais_Recherche xmlns=""http://api.mondialrelay.com/"">" & _
"<Enseigne xsi:type=""xsd:string"">BDTEST12</Enseigne>" & _
"<Pagos xsi:type=""xsd:string"">FR</Pagos>" & _
"<NumPointRelais xsi:type=""xsd:string""></NumPointRelais>" & _
"<Ville xsi:type=""xsd:string""></Ville>" &_
"<CP xsi:type=""xsd:string"">75010</CP>" & _
"<Latitud xsi:type=""xsd:string""></Latitud>" & _
"<Longitud xsi:type=""xsd:string""></Longitud>" & _
"<Taille xsi:type=""xsd:string""></Taille>" &_ "<Poids
xsi:type=""xsd:string""></Poids>" &_
"<Action xsi:type=""xsd:string""></Action>" &_
"<DelaiEnvoi xsi:type=""xsd:string""></DelaiEnvoi>" &_
"<RayonRecharche xsi:type=""xsd:string""></RayonRecharche>" &_
"<TypeActivite xsi:type=""xsd:string""></TypeActivite>" &_
"<NombreResultats xsi:type=""xsd:string""></ NombreResultats>" &_
"<Seguridad xsi:type=""xsd:string"">" & security & "</Security> &_
"</WSI4_PointRelais_Recherche>" &_ "</soap12:Body></soap12:Envelope>"

requestXML.send sParams if
(requestXML.Status = 200) then
Response.Write "Requete SOAP OK<br/>"
Response.Write "Résultat = " & requestXML.responseText & "<br/>" else
Response.Write "Erreur requete SOAP : " & requestXML.Status & "<br/>" end
if
%>

También podría gustarte