Transmettre la nouvelle commande COMBO

CALL

Cette API permet de nous envoyer une nouvelle VILLE, DISTRI ou SPRINT.

URL https://api.asx.be/COMBO/
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 * 1234 Il s'agit du numéro de client chez ON TIME Logistics. numérique, sans zéros précédents.
1 apipswd * c40b0c360f3d4959b53b103b25759542 Mot de passe du compte API
1 omgeving * TEST TEST = Environnement TEST
LIVE = Environnement LIVE
1 service * CITY VILLE, DISTRI de SPRINT
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 ophalen
  2 datum   2025-01-14 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 uur   16:15 Format de l'heure HH:MM
À compléter uniquement s'il y a une date limite
  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 adres1 * Kattendijkdok 5A Nom de la rue + Numéro de maison + numéro de bus
250 caractères maximum
  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
Seulement BE, NL, LU possibles !
NL et LU uniquement possible pour le service DISTRI
1 leveren
  2 datum   2025-01-14 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 uur   16:15 Format de l'heure HH:MM
À compléter uniquement s'il y a une date limite
  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 adres1 * Kattendijkdok 5A Nom de la rue + Numéro de maison + numéro de bus
250 caractères maximum
  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
Seulement BE, NL, LU possibles !
NL et LU uniquement possible pour le service DISTRI
1 goederen
  2 goed
  3 aantal * 7 Nombre de documents/colis à traiter pour cette mission
Champ numérique
  3 type * PAKKET PACKAGE ou LETTRE
  3 gewicht * 1.25 Poids en KG
Utiliser le point décimal POINT
  3 breedte (*) 7 Largeur en CM
(*) SINGLE si type = PAQUET
Utiliser le point décimal POINT
  3 hoogte (*) 7 Hauteur en CM
(*) SINGLE si type = PAQUET
Utiliser le point décimal POINT
  3 lengte (*) 7 Longueur en CM
(*) SINGLE si type = PAQUET
Utiliser le point décimal POINT
  3 oms Description Description des marchandises

Exemple JSON avec 1 x marchandises 

                                    
                                      

                                        
 
                                            Exemple JSON avec 2 x marchandises
                                            

                                    
                                        

                                    

                                

                                

                                    

                                  

                                  

                                        

                                            Exemple XML avec 1 x marchandises
                                            
<?xml version="1.0" encoding="utf-8"?>
<WebOrder> 
    <verwerking>CREATE</verwerking>
    <gebruiker>info@ontime.be</gebruiker>
    <klantnr>1234</klantnr>
    <apipswd>c40b0c360f3d4959b53b103b25759542</apipswd>
    <omgeving>TEST</omgeving>
    <service>CITY</service>
    <verzender>
        <contact>Ann Flecyn</contact>
        <email>info@ontime.be</email>
        <referentie>dit is een test</referentie>
        <tel>0123456789</tel>
    </verzender> 
    <ophalen>
        <datum>2020-01-27</datum>
        <uur>16:15</uur>
        <bedrijf>Ontime Logistics</bedrijf>
        <contact>Jean-Claude Van Den Berghe</contact>
        <adres1>Kattendijkdok 5A</adres1>
        <adres2></adres2>
        <postcode>2000</postcode>
        <gemeente>Antwerpen</gemeente>
        <tel>963214785</tel>
    </ophalen>  
    <leveren>
        <datum>2020-01-27</datum>
        <uur>16:15</uur>
        <bedrijf>Ontime Logistics</bedrijf>
        <contact>Jean-Claude Van Den Berghe</contact>
        <adres1>Kattendijkdok 5A</adres1>
        <adres2></adres2>
        <postcode>2000</postcode>
        <gemeente>Antwerpen</gemeente>
        <tel>963214785</tel>
    </leveren> 
    <goederen>
        <goed>
            <aantal>1</aantal>
            <type>PAKKET</type>
            <gewicht>1.25</gewicht>
            <lengte>0.5</lengte>
            <breedte>0.5</breedte>
            <hoogte>0.5</hoogte>
            <oms>omschrijving van de goederen</oms>
        </goed>
    </goederen>
</WebOrder>


                                      

                                            

                                            Exemple XML avec 2 x marchandises 
                                            
<?xml version="1.0" encoding="utf-8"?>
<WebOrder>
    <verwerking>CREATE</verwerking>
    <gebruiker>info@ontime.be</gebruiker>
    <klantnr>1234</klantnr>
    <apipswd>c40b0c360f3d4959b53b103b25759542</apipswd>
    <omgeving>TEST</omgeving>
    <service>CITY</service>
    <verzender>
        <contact>Ann Flecyn</contact>
        <email>info@ontime.be</email>
        <referentie>dit is een test</referentie>
        <tel>0123456789</tel>
    </verzender> 
    <ophalen>
        <datum>2020-01-27</datum>
        <uur>16:15</uur>
        <bedrijf>Ontime Logistics</bedrijf>
        <contact>Jean-Claude Van Den Berghe</contact>
        <adres1>Kattendijkdok 5A</adres1>
        <adres2></adres2>
        <postcode>2000</postcode>
        <gemeente>Antwerpen</gemeente>
        <tel>963214785</tel>
    </ophalen>  
    <leveren>
        <datum>2020-01-27</datum>
        <uur>16:15</uur>
        <bedrijf>Ontime Logistics</bedrijf>
        <contact>Jean-Claude Van Den Berghe</contact>
        <adres1>Kattendijkdok 5A</adres1>
        <adres2></adres2>
        <postcode>2000</postcode>
        <gemeente>Antwerpen</gemeente>
        <tel>963214785</tel>
    </leveren> 
    <goederen>
        <goed>
            <aantal>1</aantal>
            <type>PAKKET</type>
            <gewicht>1.25</gewicht>
            <lengte>0.5</lengte>
            <breedte>0.5</breedte>
            <hoogte>0.5</hoogte>
            <oms>omschrijving van de goederen</oms>
        </goed>
        <goed>
            <aantal>2</aantal>
            <type>BRIEF</type>
            <gewicht>1.25</gewicht>
            <lengte>0</lengte>
            <breedte>0</breedte>
            <hoogte>0</hoogte>
            <oms>omschrijving van de goederen</oms>
        </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
                                            ASXxxxx
                                            Le numéro de commande
                                        
 
                                        

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

                                        

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

                                    
                                

                                      

                                  
 
                                  

                                    
                                        

                                             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 een stadsopdracht aangemaakt</remark>
    </remarks>
    <opdrachten>
        <opdracht>
            <nummer>ASDxxxxx</nummer>
            <track>https://track.asx.be/xxxxx</track>
            <pdf>https://portal.asx.be/pdf/bestelling/?bestelling=zzzzzzz</pdf>
        </instructie>
    </instructies>
</WebAnswer>


                                      

                                        

                                            Réponse XML à ERROR  
                                        
<?xml version="1.0" encoding="utf-8"?>
<WebAnswer> 
    <status>ERROR</status>
    <remarks>
        <remark>opdracht - datum kan niet in het verleden liggen</remark>
        <remark>opdracht - bestemming-bedrijf 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 :