L'API Hello Harel utilise des références externes pour garder en mémoire les identifiants utilisés par les applications externes. Cela vous permet de ne pas vous soucier des identifiants internes de Hello Harel et d'utiliser les vôtres à la place.
Par exemple, lors de la première création d'une commande de vente par POST /api/v1/orders, vous pouvez passer le contact associé à la commande sous la forme suivante :

"contact": { "externalReference": "my_own_reference", "firstName": "Timothy", "lastName": "Jollivet", "email": "timothy.jollivet@helloharel.com" },
Lors des utilisations suivantes, vous pourrez à nouveau passer la référence externalReference et le contact sera automatiquement associé.

Les entités concernées sont :

  • Les contacts

  • Les conditionnements

  • Les commandes.