API MapsTime TMS

L'API de MapsTime TMS permet de rechercher vos positions et de créer des positions.

Une sandbox est disponible à l'adresse  https://app.mapstime.fr/swagger/#/positions décrivant l'API avec l'outil Swagger UI. Cette interface vous permet de prendre connaissance de la documentation de l'API et de tester des appels aux différents points d'entrée de l'API.

Afin d'utilisez l'API MapsTime TMS, vous devez disposez d'un jeton d'authentification. Vous pouvez nous contacter à l'adresse support@mapstime.fr afin de l'obtenir.

Authentification

À chaque appel à l'API, vous devez transmettre votre jeton d'authentification dans l'entête HTTP Authorization.

Recherche de positions

L'API de recherche de positions est disponible avec un appel HTTP GET sur la ressource /positions. 3 critères de recherche sont disponibles pour filtrer vos positions :

• La date de dernier changement de statut

# Recherche sur un jour donné
curl -X GET -H 'Authorization: MyToken' https://app.mapstime.fr/api/v1/positions?date=2017-02-08
# Recherche sur une période donnée
curl -X GET -H 'Authorization: MyToken' https://app.mapstime.fr/api/v1/positions?date=2017-02-08:2017-02-10

• Le statut des positions (En cours, Terminé)

curl -X GET -H 'Authorization: MyToken' https://app.mapstime.fr/api/v1/positions?status=En%20Cours<br>

• Le contact associé aux positions (Nom du contact ou numéro de SIRET)

curl -X GET -H 'Authorization: MyToken' https://app.mapstime.fr/api/v1/positions?contact=DB%20Schenker<br>

Création de position

L'API de création de positions est disponible avec un appel HTTP POST sur la ressource /positions.

curl -X POST -H 'Authorization: MyToken' -H 'Content-Type: application/json' https://app.mapstime.fr/api/v1/positions -d '{
  "type": "delivery",
  "contact": "01234567890123",
  "externalId": "123456789",
  "receiptNumber": "12345678",
  "number": 1,
  "packageNumber": 1,
  "unit": "package",
  "details": {
    "weight": 10.4,
    "returnable": false
  },
  "receiver": {
    "name": "TEST 1",
    "address": {
      "city": "ST MALO",
      "zipCode": "35400",
      "street": "ADRESSE 1",
      "streetComplement": "ADRESSE 2"
    }
  },
  "sender": {
    "company": "SCHENKER FRANCE 35",
    "address": {
      "city": "RHEU LE",
      "zipCode": "35650",
      "street": "PARC D ACTIVITES DES CORMIERS",
      "streetComplement": "4 RUE DES CORMIERS"
    }
  },
  "delivery": {
    "instructions": "TEST DE TRANSMISSION",
    "withMeeting": false
  }
}'