¶ MODE Opératoire
¶ API ORDER : {{baseURL}}/v1/order/manifest/create
¶ Détail du Json Manifest CreaTE
Le document ci-joint va décrypter un Json dans sa globalité pour aider à la compréhension de ce dernier et permettre la création d’un mapping pour les clients.
¶ Entête
|
1 2 3 4 5 |
{ "number": "SHIP-2026-0625-001", "departureDate": "2026-06-25", "consignorCode": "SOCOTEC", "carrierCode": "TRC 13", "subcontractorCode": "", |
N° de bordereau EDI Date de départ en SAS EDI Remettant (Consignor) Agence dans Teliway (carriercode) Code Sous-traitant (ex : CHRONO750) |
¶ Segment order
|
6 7 8 9 10 11 12 13 14 15 16 17 18
19 |
"uuid": "", "ediReference": "EDI-FR-2026-0625-001", "type": "PIC", "pickupMode": " ??", "contractorCode": "SOCOTEC", "consignorCode": "SOCOTEC", "carrierCode": "TRC 13", "serviceCode": "XPINT", "receipt": "REC-2026-0625-001", "shipmentDate": "2026-06-25", "consignorReference": "REF-FR-CHEM-001-2026", "consigneeReference": "REF-CH-ZUR-001-2026", "goodsDescription": "Sodium Hydroxide Solution (UN 1845) - Dangerous Goods", "shippingType": "P", |
Identifiant unique créé automatiquement en réponse et utiliser dans d’autres API, RFF Reçu Type de position livraison « DEL », pick-up « PIC »,
Code Donneur d’ordre, Nom Donneur d’ordre Code agence Teliway Code Produit de vente / Trafic de Vente Numéro de récépissé Date d’exploitation et Date départ souhaitée Réf donneur d’ordre Réf. Destinataire (Consignee) Nature marchandise à la position,
Type de port. « P » Payé, « C » Port Dû, « F » Service, « R » Port Dû en compte, « G » Gratuit |
¶ Segment Pickup – Consignor / Expéditeur
|
20 21 22 23 24 25 26 27 28 29 30
31 32 33 34 35
|
"pickup": { "code": "SOCOTEC", "name": "Chemical Solutions France", "name2": "Logistics Department", "address1": "12 Rue de la Chimie", "address2": "", "address3": "", "address4": "", "country": "FR", "zip": "75015", "city": "Paris", "region": "Île-de-France", "contact": { "name": "Jean Dupont", "email": "jean.dupont@chemicalsolutions.fr", "mobile": "+33 6 12 34 56 78", "telephone": "+33 1 23 45 67 89", "fax": "+33 1 23 45 67 90" }, "latitude": 48.8566, "longitude": 2.3522 |
Code Expéditeur Nom Expéditeur Nom (suite) Adresse Expéditeur
Pays Expéditeur Code postal Expéditeur Ville Expéditeur Région Expéditeur
Contact Expéditeur Email Expéditeur Portable Expéditeur Téléphone Expéditeur Fax Expéditeur
Coordonnées GPS mais si vide Teliway géolocalisera le tiers |
¶ Segment Consignee – Destinataire
|
36 37 38 39 40 41 42 43 44 45 46
47 48 49 50 51
|
"consignee": { "code": "CH-ZURICH-001", "name": "Swiss Industrial Chemicals", "name2": "Receiving Warehouse", "address1": "Industriestrasse 10", "address2": "", "address3": "", "address4": "", "country": "CH", "zip": "8005", "city": "Zurich", "region": "Zurich", "contact": { "name": "Hans Müller", "email": "hans.mueller@swissindustrial.ch", "mobile": "+41 79 123 45 67", "telephone": "+41 44 123 45 68", "fax": "+41 44 123 45 69" }, "latitude": 47.3769, "longitude": 8.5417 |
Code destinataire Nom destinataire Nom (suite) Adresse destinataire
Pays destinataire Code postal destinataire Ville destinataire Région destinataire
Contact destinataire Email destinataire Portable destinataire Téléphone destinataire Fax destinataire
Idem expéditeur non nécessaire |
¶ Segment order suite
|
52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 |
"incoterm": "DAP", "deliveryDateTime": "2026-06-26T10:00:00.000Z", "deliveryEarliestDateTime": "2026-06-26T08:00:00.000Z", "deliveryLatestDateTime": "2026-06-26T12:00:00.000Z", "mandatoryDelivery": true, "pickupDateTime": "2026-06-25T14:00:00.000Z", "pickupEarliestDateTime": "2026-06-25T12:00:00.000Z", "pickupLatestDateTime": "2026-06-25T16:00:00.000Z", "deliveryInstructions": "Livrer à quai, prévenir 24h à l'avance.", "pickupInstructions": "Prévoir un véhicule équipé pour marchandises dangereuses (ADR).", "remarks": "Manipuler avec précaution. Éviter les chocs et les sources de chaleur.", "deliveryAppointment": true, "pickupAppointment": true, "deliveryIndividual": false, "pickupIndividual": false, |
Incoterm Date et heure de livraison demandée Date début de livraison + heure Date de fin de livraison + heure Est impérative Date souhaitée d’enlèvement Date début + fin d’enlèvement Date de fin + heure d’enlèvement Instruction de livraison Instruction d’enlèvement Remarques RdV obligatoire en livraison RdV obligatoire en enlèvement Livraison d’un particulier Enlèvement chez un particulier |
¶ Segment Packing
|
67 68 69 70 71 72 73 74 75 |
"packing": { "handlingUnitNumber": 2, "palletsTotalNumber": 2, "parcelsTotalNumber": 0, "taxableUnitNumber": 1, "grossVolume": 4.5, "grossWeight": 1200, "loadingMeters": 3.2, "length": 2.4, "goodsDescription": "2 palettes de Sodium Hydroxide Solution (UN 1845)" |
Nombre d’UM Nombre de palettes Nombre de colis Nombre d’unité taxable Volume position en M3 Poids total en Kg MPL Longueur Idem champ 18 |
/!\ Attention une partie de ces champs ne sont pas visibles en colisage lot /!\
¶ Segment Handling Unit
|
76 77
78 79 80 81 82 83 84 85 86 87 88 89 90 |
"handlingUnits": [ { "index": 1, "uuid": "", "reference": "HU-2026-0625-001", "barcode": "12345678901234567890", "masterBarcode": "", "description": "", "packageInfo": "", "weight": 600, "volume": 2.25, "length": 1.2, "height": 1.8, "width": 1.0, "loadingMeter": 1.6, "parcelsNumber": 1, "text1": "ADR Required", "text2": "Corrosif - Classe 8", "text3": "", "text4": "", "consignorReference": "REF-FR-CHEM-001-2026", "barcodeSSCC": "98765432109876543211" |
« index » 1 = 1ère UM, le second tableau devra être index 2, ect… Identifiant unique de l’UM peut être généré par Teliway Ref transporteur à l’UM Code barre UM (peut être généré par Teliway) Non utilisé en API Non utilisé en API Non utilisé en API Poids de l’UM en KG Volume de l’UM en M3 Longueur en mètre Hauteur en mètre Largeur en mètre MPL – Mètre plancher linéeaire Nombre de colis Ligne info 1 Ligne info 2 Ligne info 3 Ligne info 4 Ref Expéditeur Code Barre SSCC – Serial Shipping Container Code |
¶ Suite segment Order
|
91 92
93 94 |
"additionalData": [ { "code": "TEMPERATURE_CONTROL", "value": "AMBIANT" }, { "code": "ADR_REQUIRED", "value": "YES" } ], "returnablePackaging": [ { "number": 0, "type": "string" } ], "codValue": { "amount": 0, "currency": "EUR" |
Non utilisé en API
Non utilisé en API Non utilisé en API
Non utilisé en API Non utilisé en API
Emballage consigné
Nombre d’emballage consigné Code emballage consigné
Contre remboursement Montant Devise |
¶ Suite segment order
|
95 96
97 98 |
"declaredValue": { "amount": 5000, "currency": "EUR" }, "goodsValue": { "amount": 5000, "currency": "EUR" |
Valeur déclarée Montant Devise
Valeur marchandise Montant Devise |
¶ Segments Items – Détails Articles
|
99 100 101 102 103
104
105 106 107 108 109 |
"items": [ { "code": "CHEM-1845-001", "label": "Sodium Hydroxide Solution (UN 1845)", "quantity": 2, "weight": 1200, "goodsDescription": "Solution de soude caustique à 50%, 1000L par jerrican", "orderNumber": "ORD-2026-0625-001", "orderDate": "2026-06-20", "orderReference": "REF-ORD-2026-0625-001", "customerRef": "CUST-FR-001", "customerRef2": "", "deliveryNoteNumber": "DN-2026-0625-001", "supplierCode": "SUPP-CHEM-001", "buyerCode": "BUY-CH-001", "itemGroup": "CHEMICALS", "itemGroupLabel": "Produits chimiques dangereux", |
Code EAN – European Article Numbering Libellé merchandise Nombre de pièces Poids unitaire Nature marchandise à l’article Non utilisé Non utilisé Non utilisé Référence client Non utilisé N° de bon de livraison Code fournisseur Code acheteur Code famille Libellé famille |
¶ Segment items – Détail article
|
110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 |
"customsRate": "0802", "originCountry": "FR", "unitValue": 2500, "totalValue": 5000, "length": 1.2, "volume": 4.5, "HUReference": "HU-2026-0625-001", "text1": "UN 1845", "text2": "Classe 8 - Corrosif", "text3": "ADR Required", "text4": "", "text5": "", "referencePAN": "", "importCustomsRate": "1503", "customsValue": 0, "hUReference": "HU-2026-0625-001" } |
Tarif douanier / HS Code Pays d’origine Valeur unitaire Valeur douanière Longueur en mètre Volume unitaire en M3 Réf transporteur (UM) Texte 1 Texte 2 Texte 3 Texte 4 Texte 5 Référence type PAN Tarif douanier import Valeur douanière à l’article Réf transporteur (UM) idem ligne 116
|
¶ Segment Dangerous Goods – ADR (Accord relatif au transport international des marchandises dangereuses par route)
|
126
127 128 129 130 131 132 133 |
"UNCode": "1845", "category": "", "classification": "", "packingGroup": 2, "packingInstruction": "P001", "instructions": "", "packagingNumber": 2, "packagingDescription": "fût", "packagingType": "1G", "grossWeight": 1200, "netQuantity": 500, "wasteTransport": false, "dangerousForEnvironment": true, |
Code ONU Sert à faire un look up pour notre BDD ADR Sert à faire un look up pour notre BDD ADR Sert à faire un look up pour notre BDD ADR Sert à faire un look up pour notre BDD ADR Sert à faire un look up pour notre BDD ADR Nombre d’emballage Type d’emballage Code emballage ADR Poids Brut Quantité déclarée Type d’emballage Code ADR Emballage |
¶ SEGMENT DANGEROUS GOODS – ADR (ACCORD RELATIF AU TRANSPORT INTERNATIONAL DES MARCHANDISES DANGEREUSES PAR ROUTE)
|
134
135 136 137 138 139 140 141 142 143 144 |
"specialInstructions": "Porter des gants et des lunettes de protection lors de la manipulation.", "technicalName": "Sodium Hydroxide Solution", "class": "", "label1": "CORROSIVE", "label2": "", "label3": "", "label4": "", "limitedQuantity": "0", "exceptedQuantity": "1", "unit": "LTR", "uNCode": "1845" } |
Disposition particulière
N.S.A : Nom technique Non utilisé car récupéré grâce au Code ONU Sert à faire un look up pour notre BDD ADR Sert à faire un look up pour notre BDD ADR Sert à faire un look up pour notre BDD ADR Sert à faire un look up pour notre BDD ADR Quantité limitée. Valeur « 0 » ou « 1 » Quantité exceptée. Valeur « 0 » ou « 1 » Unité : Litre « LTR », Kilo « KG », Volume « MQT » Doit reprendre la ligne 126 |
¶ Suite segment Order 2
|
145
146 147 148 149 150 151 |
], "subcontractorServiceCode": "CHR13", "complementaryServices": [ { "code": "UN1845", "label": "Transport de marchandises ADR", "type": 1, "quantity": 1, "unit": "1", "parameter": "CLASSE_8" } ], |
Code de produit de sous-traitance SàD – Option de contrat de transport
Code SàD Libellé Type entre « 0 » et « 8 ». Non fonctionnel à date Quantité de SAD Poids « KGM », Longueur « LEN », Volume « VOL ». Paramètre |
¶ Segment Invoice – Facture
/!\ Activer la propriété pour la facture Douane pour les voir à la position /!\
|
152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 |
"invoice": { "number": "INV-2026-0625-001", "exportReason": "SALE", "termsOfDelivery": "DAP", "type": "COMMERCIAL", "originCountry": "FR", "name": "Chemical Solutions France", "contact": "Jean Dupont", "telephone": "+33 1 23 45 67 89", "email": "invoices@chemicalsolutions.fr", "address1": "12 Rue de la Chimie", "address2": "", "address3": "", "country": "FR", "region": "Île-de-France", "zip": "75015", "city": "Paris", |
N° de facture Raison d’export Incoterm Type facture. « Proforma » ou « Commerciale ». Non fonctionnel à date Pays d’origine Nom Contact Téléphone Adresse 1 Adresse 2 Adresse 3 Pays Région Code postal Ville |
¶ Segment Invoice – Facture
|
168 169 170 171 172 173 174 175 176 |
"vatNumber": "FR1234567890", "signatory": "Jean Dupont", "currency": "EUR", "copy": 1, "category": "CHEMICALS", "exportType": "EXP", "eori": "FREORI123456789", "complementaryText": "Facture pour transport de marchandises dangereuses.", "netWeight": 1200 }, |
N° de TVA Signataire Devise Nombre d’exemplaire Catégorie Type d’export sur 3 caractères N° EORI - Economic Operator Registration and Identification Texte Complémentaire Poids Net |
¶ Conclusion du JSON
|
177 178 179 |
}, "invoicingAccount": "ACCT-FR-001", "serviceCategory": "EXPRESS", "analyticAccount": "" } |
Compte de facturation reçu en EDI (CAG 1296) Nature de prestation Non utilisé en API |
¶ Correspodance avec Teliway
¶ SAS EDI + Type position
¶ Pour les sous-traitants – Onglet évènement position
¶ Segment Order
¶ Onglet Complément position
¶ Généralités - Expéditeur
¶ Généralités – Destinataire
¶ Généralités - Champs Livraison
¶ Champs enlèvement – Onglet enlèvement
¶ Généralité – Colisage
¶ Généralités - Valeur
¶ Généralités – Emballage
¶ Généralité – Option contrat de transport
¶ Segment UM
¶ Segment Item
¶ Segment Dangerous Good
¶ Segment Invoice
¶ Exemple de JSON
{
"number": "SHIP-2026-0625-001",
"departureDate": "2026-06-25",
"consignorCode": "SOCOTEC",
"carrierCode": "TRC 13",
"subcontractorCode": "",
"orders": [
{
"uuid": "",
"ediReference": "EDI-FR-2026-0625-001",
"type": "PIC",
"pickupMode": "0",
"contractorCode": "SOCOTEC",
"consignorCode": "SOCOTEC",
"carrierCode": "TRC 13",
"serviceCode": "XPINT",
"receipt": "REC-2026-0625-001",
"shipmentDate": "2026-06-25",
"consignorReference": "REF-FR-CHEM-001-2026",
"consigneeReference": "REF-CH-ZUR-001-2026",
"goodsDescription": "Sodium Hydroxide Solution (UN 1845) - Dangerous Goods",
"shippingType": "P",
"pickup": {
"code": "SOCOTEC",
"name": "Chemical Solutions France",
"name2": "Logistics Department",
"address1": "12 Rue de la Chimie",
"address2": "",
"address3": "",
"address4": "",
"country": "FR",
"zip": "75015",
"city": "Paris",
"region": "Île-de-France",
"contact": {
"name": "Jean Dupont",
"email": "jean.dupont@chemicalsolutions.fr",
"mobile": "+33 6 12 34 56 78",
"telephone": "+33 1 23 45 67 89",
"fax": "+33 1 23 45 67 90"
},
"latitude": 48.8566,
"longitude": 2.3522
},
"consignee": {
"code": "CH-ZURICH-001",
"name": "Swiss Industrial Chemicals",
"name2": "Receiving Warehouse",
"address1": "Industriestrasse 10",
"address2": "",
"address3": "",
"address4": "",
"country": "CH",
"zip": "8005",
"city": "Zurich",
"region": "Zurich",
"contact": {
"name": "Hans Müller",
"email": "hans.mueller@swissindustrial.ch",
"mobile": "+41 79 123 45 67",
"telephone": "+41 44 123 45 68",
"fax": "+41 44 123 45 69"
},
"latitude": 47.3769,
"longitude": 8.5417
},
"incoterm": "DAP",
"deliveryDateTime": "2026-06-26T10:00:00.000Z",
"deliveryEarliestDateTime": "2026-06-26T08:00:00.000Z",
"deliveryLatestDateTime": "2026-06-26T12:00:00.000Z",
"mandatoryDelivery": true,
"pickupDateTime": "2026-06-25T14:00:00.000Z",
"pickupEarliestDateTime": "2026-06-25T12:00:00.000Z",
"pickupLatestDateTime": "2026-06-25T16:00:00.000Z",
"deliveryInstructions": "Livrer à quai, prévenir 24h à l'avance.",
"pickupInstructions": "Prévoir un véhicule équipé pour marchandises dangereuses (ADR).",
"remarks": "Manipuler avec précaution. Éviter les chocs et les sources de chaleur.",
"deliveryAppointment": true,
"pickupAppointment": true,
"deliveryIndividual": false,
"pickupIndividual": false,
"packing": {
"handlingUnitNumber": 1,
"palletsTotalNumber": 2,
"parcelsTotalNumber": 0,
"taxableUnitNumber": 1,
"grossVolume": 4.5,
"grossWeight": 1200,
"loadingMeters": 3.2,
"length": 2.4,
"goodsDescription": "2 palettes de Sodium Hydroxide Solution (UN 1845)"
},
"handlingUnits": [
{
"index": 1,
"uuid": "h1u2j3k4-l5m6-7n8o-p9q0-r1s2t3u4v5w6",
"reference": "HU-2026-0625-001",
"barcode": "12345678901234567890",
"masterBarcode": "98765432109876543210",
"description": "Palette 1 - Sodium Hydroxide Solution (UN 1845)",
"packageInfo": "Jerrican en plastique, 1000L",
"weight": 600,
"volume": 2.25,
"length": 1.2,
"height": 1.8,
"width": 1.0,
"loadingMeter": 1.6,
"parcelsNumber": 1,
"text1": "ADR Required",
"text2": "Corrosif - Classe 8",
"text3": "",
"text4": "",
"consignorReference": "REF-FR-CHEM-001-2026",
"barcodeSSCC": "98765432109876543211"
},
{
"index": 2,
"uuid": "x1y2z3a4-b5c6-7d8e-f9g0-h1i2j3k4l5m6",
"reference": "HU-2026-0625-002",
"barcode": "09876543210987654321",
"masterBarcode": "12345678901234567891",
"description": "Palette 2 - Sodium Hydroxide Solution (UN 1845)",
"packageInfo": "Jerrican en plastique, 1000L",
"weight": 600,
"volume": 2.25,
"length": 1.2,
"height": 1.8,
"width": 1.0,
"loadingMeter": 1.6,
"parcelsNumber": 1,
"text1": "ADR Required",
"text2": "Corrosif - Classe 8",
"text3": "",
"text4": "",
"consignorReference": "REF-FR-CHEM-001-2026",
"barcodeSSCC": "12345678901234567892"
}
],
"additionalData": [
{
"code": "",
"value": ""
},
{
"code": "",
"value": ""
}
],
"returnablePackaging": [],
"codValue": {
"amount": 0,
"currency": "EUR"
},
"declaredValue": {
"amount": 5000,
"currency": "EUR"
},
"goodsValue": {
"amount": 5000,
"currency": "EUR"
},
"items": [
{
"code": "CHEM-1845-001",
"label": "Sodium Hydroxide Solution (UN 1845)",
"quantity": 2,
"weight": 1200,
"goodsDescription": "Solution de soude caustique à 50%, 1000L par jerrican",
"orderNumber": "ORD-2026-0625-001",
"orderDate": "2026-06-20",
"orderReference": "REF-ORD-2026-0625-001",
"customerRef": "CUST-FR-001",
"customerRef2": "",
"deliveryNoteNumber": "DN-2026-0625-001",
"supplierCode": "SUPP-CHEM-001",
"buyerCode": "BUY-CH-001",
"itemGroup": "CHEMICALS",
"itemGroupLabel": "Produits chimiques dangereux",
"customsRate": "0%",
"originCountry": "FR",
"unitValue": 2500,
"totalValue": 5000,
"length": 1.2,
"volume": 4.5,
"HUReference": "HU-2026-0625-001",
"text1": "UN 1845",
"text2": "Classe 8 - Corrosif",
"text3": "ADR Required",
"text4": "",
"text5": "",
"referencePAN": "",
"importCustomsRate": "0%",
"customsValue": 0,
"hUReference": "HU-2026-0625-001"
}
],
"dangerousGoods": [
{
"UNCode": "1845",
"category": "CORROSIVE",
"classification": "8",
"packingGroup": 2,
"packingInstruction": "P001",
"instructions": "Ne pas mélanger avec des acides. Stocker dans un endroit sec et ventilé.",
"packagingNumber": 2,
"packagingDescription": "fût",
"packagingType": "1G",
"grossWeight": 1200,
"netQuantity": 2000,
"wasteTransport": false,
"dangerousForEnvironment": true,
"specialInstructions": "Porter des gants et des lunettes de protection lors de la manipulation.",
"technicalName": "Sodium Hydroxide Solution",
"class": "8",
"label1": "CORROSIVE",
"label2": "",
"label3": "",
"label4": "",
"limitedQuantity": "0",
"exceptedQuantity": "1",
"unit": "LTR",
"uNCode": "1845"
}
],
"subcontractorServiceCode": "",
"complementaryServices": [
{
"code": "UN1845",
"label": "Transport de marchandises dangereuses (ADR)",
"type": 1,
"quantity": 1,
"unit": "1",
"parameter": "CLASSE_8"
}
],
"invoice": {
"number": "INV-2026-0625-001",
"exportReason": "SALE",
"termsOfDelivery": "DAP Zurich",
"type": "COMMERCIAL",
"originCountry": "FR",
"name": "Chemical Solutions France",
"contact": "Jean Dupont",
"telephone": "+33 1 23 45 67 89",
"email": "invoices@chemicalsolutions.fr",
"address1": "12 Rue de la Chimie",
"address2": "",
"address3": "",
"country": "FR",
"region": "Île-de-France",
"zip": "75015",
"city": "Paris",
"vatNumber": "FR1234567890",
"signatory": "Jean Dupont",
"currency": "EUR",
"copy": 1,
"category": "CHEMICALS",
"exportType": "EXPORT",
"eori": "FREORI123456789",
"complementaryText": "Facture pour transport de marchandises dangereuses.",
"netWeight": 1200
},
"invoicingAccount": "ACCT-FR-001",
"serviceCategory": "EXPRESS",
"analyticAccount": "ANALYTIC-CHEM-001"