Envoi d'un nouvel ordre de DISTRIBUTION

CALL

Cette API permet de nous envoyer un nouvel ordre de distribution.

URL https://api.asx.be/DISTRI/
METHOD POST
REQUEST / INPUT

Vous trouverez ci-dessous la structure utilisée comme entrée, ainsi qu'un exemple illustratif et des informations complémentaires pour chaque champ.
Vous pouvez choisir de nous envoyer les données via JSON ou XML.

Niveau/champ Obligatoire Exemple Description
1 verwerking * CREATE Une nouvelle commande sera créée une fois que toutes les vérifications auront été effectuées
1 gebruiker * info@ontime.be Adresse électronique sur laquelle le compte API a été défini.
250 caractères maximum
1 klantnr * K01234 Il s'agit du numéro de client DISTRI chez ON TIME Logistics.
Numérique, précédé d'un
1 apipswd * c40b0c360f3d4959b53b103b25759542 Mot de passe du compte API
1 omgeving * TEST TEST = Environnement TEST
LIVE = Environnement LIVE
1 verzender
  2 contact * Ann Flecyn Nom de la personne qui crée l'ordre
250 caractères maximum
  2 email * info@ontime.be L'adresse électronique de la personne qui crée la commande
250 caractères maximum
  2 referentie * dit is een test Référence générale qui sera mentionnée sur la facture
30 caractères maximum
  2 tel * 0123546789 Numéro de téléphone de la personne qui crée la commande SANS caractères
1 webhook Cette option n'est nécessaire que si vous souhaitez recevoir le suivi automatiquement dès qu'il y a un changement de statut.
Pour plus d'informations à ce sujet, consultez la documentation sur les webhooks.
  2 functie URL Valeurs possibles: FTP de URL
Si vous choisissez FTP, la connexion FTP doit être établie par nos administrateurs.
  2 url https://www.urlnaaruwscript n'est nécessaire que si FUNCTIE = URL
  2 methode POST Si FUNCTIE = URL => sélectionner POST de GET
Si FUNCTIE = XML => sélectionner XML de JSON
  2 email your@email.be pas obligatoire, mais si aucune connexion ne peut être établie avec votre fonction webhook ET que cette adresse e-mail est définie, nous vous enverrons un e-mail contenant des informations sur l'état de la situation.
1 opdracht
  2 rembours_bedrag   123.45 Contre remboursement (si nécessaire)
  2 rembours_munt   EUR Monnaie de Rebours.
Si vous souhaitez récupérer les devises spécifiques à votre numéro de client, utilisez l'API devises : Cliquez ici.
  2 neutraal * 0

S'il s'agit d'une livraison neutre, utilisez

1 ophalen
  2 datum   2025-02-05 Date à laquelle cette commande doit être REÇUE
Format AAAA-MM-JJ
Si vous n'indiquez pas cette date, cet ordre sera exécuté dès que possible.
  2 bedrijf * Ontime Logistics nom de l'entreprise
250 caractères maximum
  2 contact * Jean-Claude Van Den Berghe nom de la personne de contact au sein de l'entreprise
250 caractères maximum
  2 straat * Kattendijkdok Nom de la rue
250 caractères maximum
  2 huisnr * 5A Numéro de maison + numéro de bus
  2 adres2     Possibilité d'une deuxième ligne d'adresse
250 caractères maximum
  2 postcode * 2000 4 caractères maximum
  2 gemeente * Antwerpen 250 caractères maximum
  2 tel * 0471334455 Numéro de téléphone SANS caractères
  2 land BE S'il n'est pas rempli = BE
Si vous souhaitez récupérer les pays spécifiques à votre numéro de client, utilisez l'API pays : Cliquez ici.
  2 info_chauffeur   Ici, vous pouvez fournir des informations supplémentaires au conducteur
  2 uren
  3 maandag   09:00-12:00-13:00-17:00 Indiquez les heures d'ouverture de cette adresse de ramassage le LUNDI:
Du matin - au matin - de l'après-midi - à l'après-midi
Format : hh:mm-hh:mm-hh:mm-hh:mm
Si vous ne l'indiquez pas, la valeur par défaut sera :09:00-12:00-13:00-17:00
  3 dinsdag   09:00-12:00-13:00-17:00 Indiquez les heures d'ouverture de cette adresse de ramassage le MARDI
  3 woensdag   09:00-12:00-13:00-17:00 Veuillez indiquer les heures d'ouverture de cette adresse de ramassage le MERCREDI
  3 donderdag   09:00-12:00-13:00-17:00 Veuillez indiquer les heures d'ouverture de cette adresse de ramassage le JEUDI
  3 vrijdag   09:00-12:00-13:00-17:00 Veuillez indiquer les heures d'ouverture de cette adresse de ramassage le VENDREDI
  3 zaterdag   09:00-12:00-13:00-17:00 Veuillez indiquer les heures d'ouverture de cette adresse de ramassage le SAMEDI
  2 confirm_load ann@test.be; jan@test.com Si vous avez besoin d'une confirmation pour l'encaissement avant l'exécution de l'ordre,
Saisir l'adresse électronique à laquelle la demande de confirmation doit être envoyée
La commande ne sera exécutée que SI elle est confirmée.
Possibilité d'envoyer plusieurs courriels, séparés par des ;
1 leveren
  2 datum   2025-02-05 Date à laquelle ce commandement doit être LIVRÉ
Format AAAA-MM-JJ
Si vous n'indiquez pas cette date, cet ordre sera exécuté dès que possible.
  2 bedrijf * Ontime Logistics nom de l'entreprise
250 caractères maximum
  2 contact * Jean-Claude Van Den Berghe nom de la personne de contact au sein de l'entreprise
250 caractères maximum
  2 straat * Kattendijkdok Nom de la rue
250 caractères maximum
  2 huisnr * 5A Numéro de maison + numéro de bus
  2 adres2     Possibilité d'une deuxième ligne d'adresse
250 caractères maximum
  2 postcode * 2000 4 caractères maximum
  2 gemeente * Antwerpen 250 caractères maximum
  2 tel * 0471334455 Numéro de téléphone SANS caractères
  2 land BE S'il n'est pas rempli = BE
Si vous souhaitez récupérer les pays spécifiques à votre numéro de client, utilisez l'API pays : Cliquez ici.
  2 info_chauffeur   Ici, vous pouvez fournir des informations supplémentaires au conducteur
  2 track_email   Si vous indiquez ici une adresse électronique valide, celle-ci sera utilisée pour envoyer les
  2 uren
  3 maandag   09:00-12:00-13:00-17:00 Indiquez les heures d'ouverture de cette adresse de livraison le LUNDI:
Du matin - au matin - de l'après-midi - à l'après-midi
Format : hh:mm-hh:mm-hh:mm-hh:mm
Si vous ne l'indiquez pas, la valeur par défaut sera :09:00-12:00-13:00-17:00
  3 dinsdag   09:00-12:00-13:00-17:00 Saisissez les heures d'ouverture de cette adresse de livraison le MARDI
  3 woensdag   09:00-12:00-13:00-17:00 Saisissez les heures d'ouverture de cette adresse de livraison le MERCREDI
  3 donderdag   09:00-12:00-13:00-17:00 Indiquez les heures d'ouverture de cette adresse de livraison le JEUDI
  3 vrijdag   09:00-12:00-13:00-17:00 Indiquez les heures d'ouverture de cette adresse de livraison le VENDREDI
  3 zaterdag   09:00-12:00-13:00-17:00 Indiquez les heures d'ouverture de cette adresse de livraison le SAMEDI
1 neutraal Obligatoire si commande->neutre = 1
  2 bedrijf     nom de l'entreprise
250 caractères maximum
  2 contact     nom de la personne de contact au sein de l'entreprise
250 caractères maximum
  2 straat     Nom de la rue
250 caractères maximum
  2 huisnr   Numéro de maison + numéro de bus
  2 adres2     Possibilité d'une deuxième ligne d'adresse
250 caractères maximum
  2 postcode     4 caractères maximum
  2 gemeente     250 caractères maximum
  2 tel     Numéro de téléphone SANS caractères
  2 land   S'il n'est pas rempli = BE
Si vous souhaitez récupérer les pays spécifiques à votre numéro de client, utilisez l'API pays : Cliquez ici.
1 goederen
  2 goed
  3 product * COLLI 30-60kg - 0.4 - 0 - 60 Utilisez ici la
Si vous souhaitez récupérer les produits spécifiques à votre numéro de client, utilisez l'API produits. : Cliquez ici.
  3 aantal * 3 Nombre de documents/colis à traiter pour cette mission
Champ numérique
  3 volume   0.4 Si la valeur
Si vous ne précisez rien, les valeurs

Pour les colis et les marchandises en longueur : longueur x largeur x hauteur en mètres.
Pour les marchandises sur palettes : remplir par emplacement de palette occupé (1m³ = 1 emplacement d'europalette avec une surface au sol de 1,20m x 0,80m).
  3 gewicht   60 Si la valeur
Si vous ne précisez rien, les valeurs

  3 lengte   5 Si la valeur
Si vous ne précisez rien, les valeurs

Pour les marchandises d'une longueur supérieure à 1,5 mètre : indiquez toujours la longueur en mètres.
C'est ainsi que nous planifions votre transport sur le véhicule adapté.
  3 barcode   ABCDEF123456001|ABCDEF123456002|ABCDEF123456003 En option, vous pouvez inclure vos propres codes-barres.
Si vous le souhaitez, il doit y avoir ici autant de codes-barres que le nombre que vous introduisez dans le bon
Les codes-barres se distinguent par un
Dans notre exemple, il s'agit de 3 codes-barres.
Si vous ne fournissez pas de codes-barres, nous créerons nos propres codes-barres.

Exemple JSON avec 1 produit 

                                    
                                      

                                        

                                            Exemple JSON avec 2 produits  
                                    

                                    
                                      

                                    

                                

                                

                                    

                                  

                                  

                                        

                                            Exemple XML avec 1 produit 
                                            
<?xml version="1.0" encoding="utf-8"?>
<WebOrder> 
    <verwerking>CREATE</verwerking>
    <gebruiker>info@ontime.be</gebruiker>
    <klantnr>K01234</klantnr>
    <apipswd>c40b0c360f3d4959b53b103b25759542</apipswd>
    <omgeving>TEST</omgeving>
    <verzender>
        <contact>Jean-Claude Van Den Berghe</contact>
        <email>info@ontime.be</email>
        <referentie>dit is een test</referentie>
        <tel>123456798</tel>
    </verzender>
    <opdracht>
        <rembours_bedrag></rembours_bedrag>
        <rembours_munt></rembours_munt>
        <neutraal>0</neutraal>
    </opdracht>
    <ophalen>
        <datum>2020-01-07</datum>
        <bedrijf>Ontime Logistics</bedrijf>
        <contact>Jean-Claude Van Den Berghe</contact>
        <tel>963214785</tel>
        <straat>Kattendijkdok</straat>
        <huisnr>5A</huisnr>
        <adres2></adres2>
        <postcode>2000</postcode>
        <gemeente>Antwerpen</gemeente>
        <land>BE</land>
        <info_chauffeur>opgepast voor de hond</info_chauffeur>
        <uren>
            <maandag>09:00-12:00-13:00-17:00</maandag>
            <dinsdag>09:00-12:00-13:00-17:00</dinsdag>
            <woensdag>09:00-12:00-00:00-00:00</woensdag>
            <donderdag>09:00-12:00-13:00-17:00</donderdag>
            <vrijdag>09:00-12:00-13:00-17:00</vrijdag>
            <zaterdag>00:00-00:00-00:00-00:00</zaterdag>
        </uren>
    </ophalen>
    <leveren>
        <datum>2020-01-07</datum>
        <bedrijf>Ontime Logistics</bedrijf>
        <contact>Jean-Claude Van Den Berghe</contact>
        <tel>963214785</tel>
        <straat>Kattendijkdok</straat>
        <huisnr>5A</huisnr>
        <adres2></adres2>
        <postcode>2000</postcode>
        <gemeente>Antwerpen</gemeente>
        <land>BE</land>
        <info_chauffeur>opgepast voor de hond</info_chauffeur>
        <track_email>naam@bedrijf.com</track_email>
        <uren>
            <maandag>09:00-12:00-13:00-17:00</maandag>
            <dinsdag>09:00-12:00-13:00-17:00</dinsdag>
            <woensdag>09:00-12:00-00:00-00:00</woensdag>
            <donderdag>09:00-12:00-13:00-17:00</donderdag>
            <vrijdag>09:00-12:00-13:00-17:00</vrijdag>
            <zaterdag>00:00-00:00-00:00-00:00</zaterdag>
        </uren>
    </leveren>
    <neutraal>
        <bedrijf>Ontime Logistics</bedrijf>
        <contact>Jean-Claude Van Den Berghe</contact>
        <tel>963214785</tel>
        <straat>Kattendijkdok</straat>
        <huisnr>5A</huisnr>
        <adres2></adres2>
        <postcode>2000</postcode>
        <gemeente>Antwerpen</gemeente>
        <land>BE</land>
    </neutraal>
    <goederen>
        <goed>
            <product>COLLI 30-60kg - 0.4 - 0 - 60</product>
            <aantal>7</aantal>
            <volume>50</volume>
            <gewicht>5</gewicht>
            <lengte>5</lengte>
        </goed>
    </goederen>
</WebOrder>


                                      

                                            

                                            Exemple XML avec 2 produits 
                                        
<?xml version="1.0" encoding="utf-8"?>
<WebOrder> 
    <verwerking>CREATE</verwerking>
    <gebruiker>info@ontime.be</gebruiker>
    <klantnr>K01234</klantnr>
    <apipswd>c40b0c360f3d4959b53b103b25759542</apipswd>
    <omgeving>TEST</omgeving>
    <verzender>
        <contact>Jean-Claude Van Den Berghe</contact>
        <email>info@ontime.be</email>
        <referentie>dit is een test</referentie>
        <tel>123456798</tel>
    </verzender>
    <opdracht>
        <rembours_bedrag></rembours_bedrag>
        <rembours_munt></rembours_munt>
        <neutraal>0</neutraal>
    </opdracht>
    <ophalen>
        <datum>2020-01-07</datum>
        <bedrijf>Ontime Logistics</bedrijf>
        <contact>Jean-Claude Van Den Berghe</contact>
        <tel>963214785</tel>
        <straat>Kattendijkdok</straat>
        <huisnr>5A</huisnr>
        <adres2></adres2>
        <postcode>2000</postcode>
        <gemeente>Antwerpen</gemeente>
        <land>BE</land>
        <info_chauffeur>opgepast voor de hond</info_chauffeur>
        <uren>
            <maandag>09:00-12:00-13:00-17:00</maandag>
            <dinsdag>09:00-12:00-13:00-17:00</dinsdag>
            <woensdag>09:00-12:00-00:00-00:00</woensdag>
            <donderdag>09:00-12:00-13:00-17:00</donderdag>
            <vrijdag>09:00-12:00-13:00-17:00</vrijdag>
            <zaterdag>00:00-00:00-00:00-00:00</zaterdag>
        </uren>
    </ophalen>
    <leveren>
        <datum>2020-01-07</datum>
        <bedrijf>Ontime Logistics</bedrijf>
        <contact>Jean-Claude Van Den Berghe</contact>
        <tel>963214785</tel>
        <straat>Kattendijkdok</straat>
        <huisnr>5A</huisnr>
        <adres2></adres2>
        <postcode>2000</postcode>
        <gemeente>Antwerpen</gemeente>
        <land>BE</land>
        <info_chauffeur>opgepast voor de hond</info_chauffeur>
        <track_email>naam@bedrijf.com</track_email>
        <uren>
            <maandag>09:00-12:00-13:00-17:00</maandag>
            <dinsdag>09:00-12:00-13:00-17:00</dinsdag>
            <woensdag>09:00-12:00-00:00-00:00</woensdag>
            <donderdag>09:00-12:00-13:00-17:00</donderdag>
            <vrijdag>09:00-12:00-13:00-17:00</vrijdag>
            <zaterdag>00:00-00:00-00:00-00:00</zaterdag>
        </uren>
    </leveren>
    <neutraal>
        <bedrijf>Ontime Logistics</bedrijf>
        <contact>Jean-Claude Van Den Berghe</contact>
        <tel>963214785</tel>
        <straat>Kattendijkdok</straat>
        <huisnr>5A</huisnr>
        <adres2></adres2>
        <postcode>2000</postcode>
        <gemeente>Antwerpen</gemeente>
        <land>BE</land>
    </neutraal>
    <goederen>
        <goed>
            <product>COLLI 30-60kg - 0.4 - 0 - 60</product>
            <aantal>7</aantal>
            <volume>50</volume>
            <gewicht>5</gewicht>
            <lengte>5</lengte>
        </goed>
        <goed>
            <product>TEST</product>
            <aantal>3</aantal>
            <volume></volume>
            <gewicht></gewicht>
            <lengte></lengte>
            <barcode>ABCDEF123456001|ABCDEF123456002|ABCDEF123456003</barcode>
        </goed>
    </goederen>
</WebOrder>


                                            

                                      

                                

                            

                            
                            
                            
                        

                    

                

                

                    

                        

                            RESPONSE / OUTPUT
                        

                        

                            
                        
                        
                            
                            

                              

                                    

                                
Vous trouverez ci-dessous la structure utilisée en sortie, ainsi qu'un exemple illustratif et des informations complémentaires pour chaque champ. 

                                Si vous envoyez avec JSON, vous recevrez JSON, idem avec XML.

                                  

                                  

                                  

                                    
                                        

                                             Niveau/champ
                                            Exemple 
                                            Description
                                        

                                    
                                    
                                        

                                            1
                                            status
                                            SUCCESS 
                                             
                                        

                                        

                                            1
                                            remarks
                                        
 
                                        

                                            
                                            2
                                            remark 
                                            Er werd 1 opdracht aangemaakt
                                            Commentaires informatifs
                                        

                                        

                                            1
                                            opdrachten
                                        
 
                                        

                                            
                                            2
                                            opdracht
                                        

                                        

                                            
                                            3
                                            nummer
                                            xxxxxxx
                                            Le numéro de commande
                                        
 
                                        

                                            
                                            3
                                            track
                                            https://track.asx.be/xxxxx
                                            Lien vers la page de suivi en ligne
                                        
 
                                        

                                            
                                            3
                                            tracknr
                                            DSTRAPIxxxxx
                                            Le numéro de suivi unique.
Vous pouvez utiliser ce numéro dans notre fonctionnalité en ligne https://track.asx.be ou dans l'API de suivi.		
                                        

                                        

                                            
                                            3
                                            pdf
                                            https://portal.asx.be/pdf/bestelling/?bestel=DSTRAPIxxxxx
                                            Lien vers le formulaire de commande
                                        

                                        

                                            
                                            3
                                            label
                                            https://portal.asx.be/pdf/bestelling/?etiket=DSTRAPIxxxxx
                                            Lien vers les étiquettes
                                        

                                    
                                

                                      

                                  
 
                                  

                                    
                                        

                                             Niveau/champ
                                            Exemple 
                                            Description
                                        

                                    
                                    
                                        

                                            1
                                            status
                                            ERROR 
                                             
                                        

                                        

                                            1
                                            remarks
                                        
 
                                        

                                            
                                            2
                                            remark 
                                            foutieve credentials
                                            Liste des erreurs trouvées
                                        

                                    
                                

                                    

                                  

                                
                              
 
                                

                                    

                                  

                                        

                                            Réponse JSON à SUCCESS 
                                    

                                    
                                      

                                        

                                            Réponse JSON à ERROR 
                                    

                                    
                                      

                                    

                                

                                

                                    

                                  

                                  

                                        

                                            Réponse XML à SUCCESS  
                                            
<?xml version="1.0" encoding="utf-8"?>
<WebAnswer> 
    <status>SUCCESS</status>
    <remarks>
        <remark>Er werd 1 opdracht aangemaakt</remark>
    </remarks>
    <opdrachten>
        <opdracht>
            <nummer>xxxxx</nummer>
            <track>https://track.asx.be/xxxxx</track>
            <tracknr>DSTRAPIxxxxx</tracknr>
            <pdf>https://portal.asx.be/pdf/bestelling/?bestel=DSTRAPIxxxxx</pdf>
            <label>https://portal.asx.be/pdf/bestelling/?etiket=DSTRAPIxxxxx</label>
        </instructie>
    </instructies>
</WebAnswer>


                                      

                                        

                                            Réponse XML à ERROR  
                                        
<?xml version="1.0" encoding="utf-8"?>
<WebAnswer> 
    <status>ERROR</status>
    <remarks>
        <remark>datum kan niet in het verleden liggen</remark>
        <remark>bedrijf verplicht in te vullen</remark>
        <remark>aantal verplicht in te vullen</remark>
    </remarks>
</WebAnswer>


                                    

                                      

                                

                            

                            
                        

                    

                




                
 
                    

                        

                            CONTRÔLE/TEST                        

                        

                            
Grâce à cette fonction, vous pouvez tester n'importe quelle entrée JSON ou XML.                            

                            ATTENTION : Cette fonction est TOUJOURS exécutée dans l'environnement TEST.
 
                            

                                

                                    

                                        

                                            
                                            Votre chaîne INPUT                                        

                                      

                                            
                                        

                                    

                                

                                

                                    

                                        

                                            Le résultat/la réponse :