Forum Discussion
JB06
Écho naissant
Écho naissantPrécisions sur les dates dans l'API des factures
Bonjour,
Je travaille actuellement sur la récupération des factures fournisseurs & clients (supplier_invoices & customer_invoices).
J'ai des questions/demandes au sujet des dates.
1/ Dans l'interface web, dans la liste des factures, il y a une colonne "Ajouté le".
Sauf incompréhension de ma part, elle indique à quelle date la facture a été importée dans Pennylane (donc aucun lien avec la date d'émission de la facture).
J'ai besoin de connaître cette information, pour requêter par ex les factures qui ont été ajoutées dans pennylane après le XXXXX.
Je ne la trouve pas, serait-t-il possible de l'ajouter, dans les informations retournée, et dans les paramètres de tri ?
2/ toujours concernant des requêtes get invoices, il n'est actuellement proposé qu'un seul paramètre de tri : "date".
A quelle valeur correspond-elle :$item-> date, $item->created_at ou $item->updated_at ?
Pourrait-on aussi ajouter la date d'ajout dans les paramètres de tri ?
3/ pour les factures, la doc évoque ces 2 données de type date :
"date" : Invoice issue date (ISO 8601)
"created_at": The time the invoice has been created
Quelle est la différence entre ces 2 dates pour les factures fournisseurs ?
Merci.
Bonjour JB06
1. La colonne "Ajouté le" de l'interface web correspond au champ created_at de la facture (date de création/import de la facture dans Pennylane). Ce champ existe déjà et est bien renvoyé par l'API : les réponses des endpoints "Get supplier invoices" et "Get customer invoices" (API v2 externe, ainsi que l'API Cabinet v1) incluent created_at et updated_at en plus de date. En revanche, ce champ n'est pas disponible comme paramètre de tri : sur ces deux endpoints, le paramètre sort n'accepte que id et date. Il n'est donc pas possible aujourd'hui de trier par date d'ajout via l'API.
2. Le paramètre de tri unique date correspond à $item->date, c'est-à-dire la date d'émission de la facture — un champ distinct de created_at et de updated_at. Comme indiqué au point 1, la date d'ajout (created_at) ne fait pas partie des valeurs acceptées par sort, ni pour les factures fournisseurs ni pour les factures clients.
3. Pour les factures fournisseurs, date est la date d'émission indiquée sur le document (renseignée/éditable), tandis que created_at correspond au moment où l'enregistrement de la facture a été créé dans Pennylane (son import/ajout dans l'outil). Ces deux dates sont indépendantes : une facture peut être émise à une date donnée et être ajoutée à Pennylane à une date ultérieure différente.
4 Réponses
JB06Merci pour ces précisions, c'est très clair.
Peut-être qu'on peut utiliser le tri par id pour contourner l'absence du tri par date de création.
Est-ce que l'id d'une facture est de type incrémentiel, et se base sur la date d'ajout ?- Angélique_
Pennylaneur
Bonjour JB06
Cet identifiant est attribué au même instant que le champ created_at (date d'ajout de la facture dans Pennylane), trier par id croissant revient donc généralement au même ordre que trier par created_at croissant.
- Angélique_
Bonjour JB06
1. La colonne "Ajouté le" de l'interface web correspond au champ created_at de la facture (date de création/import de la facture dans Pennylane). Ce champ existe déjà et est bien renvoyé par l'API : les réponses des endpoints "Get supplier invoices" et "Get customer invoices" (API v2 externe, ainsi que l'API Cabinet v1) incluent created_at et updated_at en plus de date. En revanche, ce champ n'est pas disponible comme paramètre de tri : sur ces deux endpoints, le paramètre sort n'accepte que id et date. Il n'est donc pas possible aujourd'hui de trier par date d'ajout via l'API.
2. Le paramètre de tri unique date correspond à $item->date, c'est-à-dire la date d'émission de la facture — un champ distinct de created_at et de updated_at. Comme indiqué au point 1, la date d'ajout (created_at) ne fait pas partie des valeurs acceptées par sort, ni pour les factures fournisseurs ni pour les factures clients.
3. Pour les factures fournisseurs, date est la date d'émission indiquée sur le document (renseignée/éditable), tandis que created_at correspond au moment où l'enregistrement de la facture a été créé dans Pennylane (son import/ajout dans l'outil). Ces deux dates sont indépendantes : une facture peut être émise à une date donnée et être ajoutée à Pennylane à une date ultérieure différente. - JB06
(désolée il manque PR devant le titre... mais je découvre que je ne peux pas éditer mon post ... Donc il s'agit de PRECISIONS, merci.
