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'int...
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.
Angélique_
Pennylaneur
PennylaneurBonjour 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.
