Mondial Relay Pickup Points & Labels

Added 15

• Initial release: integration with the two Mondial Relay web services. API 2 (WEB SERVICE DUAL CARRIER V-2.7.1, ShipmentCreationRequest) creates shipments and labels; API 1 (WEB SERVICE V-5.14, SOAP) provides the Point Relais search (WSI4_PointRelais_Recherche) and tracking (WSI2_TracingColisDetaille) with the documented MD5 security key. The WSDL and XSD files are saved in the tests and every request is validated against them.
• Label creation from the order page or at an order status: recipient, street and house number split, weight in grams, optional parcel size and content text, sender from the Connection page; labels in PDF (10x15, A4 or A5) or ZPL stored with the order and never resized; shipment number and tracking link on the order and in an optional CS-Cart shipment.
• Record-before-call idempotency for labels: the request is saved before it is sent, runs under a per-order lock and uses a deterministic reference (OrderNo O<order>-<row>). A timeout, server error or status -1 / 99999 is an unknown result and is never repeated automatically (the web services have no cancel and no lookup).
• Unknown-result handling: the merchant adopts the 8-digit shipment number found in Mondial Relay Connect (checked with the tracking service) or confirms that nothing was created.
• Return labels (collection mode REL, delivery mode LCC, customer as sender, shop as recipient) with the same protection.
• Shipping services Point Relais (24R), Point Relais XL (24L) and Home delivery (HOM), each a shipping method with the merchant's own price (flat or by weight), free-shipping threshold, countries and weight limit. XOH (D+1) is not offered because it needs an additional EDI file.
• Point Relais picker at the checkout with the Mondial Relay widget, loaded only when the customer opens it; the choice is checked again on the server with the point search (country must match the delivery address, XL points must be in an XL search) and saved with the order. Cash on delivery is refused (ended with V-2.7.1).
• Tracking with WSI2_TracingColisDetaille by cron about every 5 hours for open shipments (Mondial Relay asks for at most 4 to 6 queries per shipment and day), every 12 hours for shipments with a problem, never for delivered ones; codes 80 to 83 mapped to created, in transit, delivered and problem, 94 (unknown parcel) keeps the state.
• Vendor rules for Multi-Vendor: marketplace owner mode or one account per vendor; in owner mode vendors cannot create labels on the owner's contract; "Run the queue now" is for administrators only.
• Data protection: no e-mail address and no phone number for Point Relais deliveries unless the setting "Send e-mail address and mobile number to Mondial Relay" is on; home delivery always sends the phone number because the document requires it; the picker panel tells the customer that the map comes from third-party servers.
• Accent transliteration and the documented character limits: names, street with number, city and address lines are written in the ASCII character set of the documented patterns and cut by characters at 30 (postal code 10, content 40, order reference 15, customer reference 9); phone numbers are normalised to the country patterns of the document.
• No labels for cancelled, declined, failed, incomplete or backordered orders.
• Connection page with encrypted credentials (API 2 login, password and customer id; API 1 brand and private key), test and live mode, sender address and a connection test; logs with masked credentials, job queue with retries and back-off, cron (command line and secret address), log viewer with CSV export, domain-bound license, self-healing upgrade synchronizer.
• Dates and times in this add-on are not protocol dates: nothing is converted to a time zone except the tracking dates and times, which are shown as Mondial Relay sends them; created and checked times use the shop time zone.
• Honest limits: no cancel operation (cancellation is local), no price operation (your own rate table), no cash on delivery, Italy, Poland and United Kingdom flows not covered.

Tested on Multi-Vendor 4.17.2. First release.