​

Soumettre des soumissions et des factures avec l’API Fournisseur

Créez des propositions pour l’approbation de l’acheteur et facturez les bons de travail terminés : brouillons de factures, sections de postes, téléversement-et-publication de PDF et effets secondaires des statuts.

export BASE="https://api.useopenwrench.com/api/external"
export KEY="<your-api-key>"
export SECRET="<shared-secret>"

​

L’argent en chaînes, par sections

​

Propositions (soumissions)

curl -X POST "$BASE/v1/supplier/quote/proposals" \
  -H "X-API-KEY: $KEY" -H "OW-KEY: $SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "workOrderId": 9001,
    "scope": "Replace condenser fan motor and recharge refrigerant.",
    "laborLineItems": [ { "description": "2 techs x 3 hrs", "amount": "540.00" } ],
    "laborTotalBeforeTax": "540.00",
    "materialLineItems": [ { "description": "Fan motor", "amount": "310.00" } ],
    "materialTotalBeforeTax": "310.00",
    "totalBeforeTax": "850.00",
    "taxRate": "8.5",
    "tax": "72.25",
    "totalAfterTax": "922.25"
  }'

• locationId, buyerFacilityId et buyerCompanyId sont dérivés du bon de travail; vous ne pouvez pas les définir.
• Les champs de taxe et les totaux de section non définis sont par défaut à "0".
• requestForProposalId prend par défaut la RFP du bon de travail lorsqu’il est omis.
• proposalPdfLink, s’il est envoyé, doit être une URL valide. attachments prend des FileDetails de l’endpoint de téléversement de fichier.
• Passer un id met à jour une proposition existante.

​

Factures

​

Le cycle de vie

​

Créer le brouillon

curl -X POST "$BASE/v1/supplier/invoice/invoices" \
  -H "X-API-KEY: $KEY" -H "OW-KEY: $SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "workOrderId": 9001,
    "invoiceNumber": "INV-2026-0451",
    "dateOfInvoice": "2026-08-21T00:00:00.000-07:00",
    "laborLineItems": [ { "description": "2 techs x 3 hrs", "amount": "540.00" } ],
    "laborTotalBeforeTax": "540.00",
    "materialLineItems": [ { "description": "Fan motor", "amount": "310.00" } ],
    "materialTotalBeforeTax": "310.00",
    "invoiceTotalBeforeTax": "850.00",
    "invoiceTaxRate": "8.5",
    "invoiceTax": "72.25",
    "invoiceTotalAfterTax": "922.25"
  }'

• poNumber prend par défaut le numéro de BC du bon de travail.
• serviceCallIds prend par défaut tous les appels de service du bon de travail lorsqu’il est omis ou vide; définissez-le explicitement lorsque vous facturez un sous-ensemble de visites.
• taxLineItems sont validés contre les types de taxe permis pour la devise de la facture (actuellement seul le CAD les prend en charge : GST/HST/PST); tout autre est rejeté.
• invoicePDFLink (une URL valide) devient la seule entrée PDF de la facture si vous hébergez le PDF vous-même; la plupart des intégrations utilisent plutôt l’endpoint de téléversement ci-dessous.
• autoPublishOnApproval inscrit cette facture à la publication automatique lorsque le bon de travail se termine.
• Sauvegarder une facture peut faire passer le statut du bon de travail associé selon la correspondance facture-vers-bon-de-travail. Un échec de validation au niveau de la sauvegarde renvoie 406.
• Passer un id met à jour une facture existante (en pratique, seulement les brouillons; les statuts côté acheteur ne vous appartiennent pas).

​

Téléverser le PDF et publier

curl -X POST "$BASE/v1/supplier/invoice/file/upload_and_publish/7710" \
  -H "X-API-KEY: $KEY" -H "OW-KEY: $SECRET" \
  -F "file=@INV-2026-0451.pdf"

​

Lire et réconcilier

​

Flux de facturation de bout en bout

1. Le bon de travail atteint l’étape de soumission : soumettez une proposition, attendez awarded.
2. Complétez le travail via le départ d’appel de service.
3. Créez le brouillon de facture; générez votre PDF.
4. Une fois que le bon de travail affiche Completed, upload_and_publish.
5. Sondez le statut de la facture jusqu’à paid, et réconciliez contre markedPaidAt.