Modifier le statut d'une facture
Ce point d'accès permet de modifier le statut d'une facture existante. Actions typiques: marquer comme payée, envoyée, annulée (void), ou en retard.
Point d'accès
POST https://canadamotorjobs.com/api/v1/{locale}/invoices/update-status
Paramètres
| Paramètre | Type | Description | Obligatoire |
|---|---|---|---|
id | string | L'identifiant de la facture | Requis |
status | string | Le nouveau statut de la facture (ex: paid, sent, void, overdue) | Requis |
paid_date | string | Date de paiement (YYYY-MM-DD HH:MM:SS), si statut est paid | Optionnel si status = paid |
payment_method | string | Méthode de paiement (ex: credit_card, bank_transfer, stripe_pm_id), si statut est paid | Non |
transaction_id | string | ID de la transaction de paiement, si statut est paid | Non |
notes | string | Notes additionnelles sur le changement de statut | Non |
api_token | string | Votre clé d'API | requis ou bearer token |
Erreurs
| Code | Message |
|---|---|
| 401 | Unauthorized |
| 404 | Not Found |
| 422 | Unprocessable Entity (ex: statut invalide, transition de statut non permise) |
| 500 | Internal Server Error |