​

Envío de cotizaciones y facturas con la Supplier API

Crea propuestas para aprobación del comprador y factura las órdenes de trabajo completadas: borradores de facturas, secciones de líneas, subida-y-publicación del PDF y efectos secundarios de estado.

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

​

El dinero son cadenas, en secciones

​

Propuestas (cotizaciones)

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 y buyerCompanyId se derivan de la orden de trabajo; no puedes establecerlos.
• Los campos de impuestos y totales de sección no establecidos toman por defecto "0".
• requestForProposalId toma por defecto el RFP de la orden de trabajo cuando se omite.
• proposalPdfLink, si se envía, debe ser una URL válida. attachments toma FileDetails del endpoint de subida de archivos.
• Pasar un id actualiza una propuesta existente.

​

Facturas

​

El ciclo de vida

​

Crear el borrador

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 toma por defecto el PO number de la orden de trabajo.
• serviceCallIds toma por defecto todas las llamadas de servicio de la orden de trabajo cuando se omite o está vacío; establécelo explícitamente cuando factures un subconjunto de visitas.
• taxLineItems se validan contra los tipos de impuestos permitidos por la moneda de la factura (actualmente solo CAD los soporta: GST/HST/PST); cualquier otro se rechaza.
• invoicePDFLink (una URL válida) se convierte en la única entrada de PDF de la factura si alojas tú mismo el PDF; la mayoría de integraciones usa en su lugar el endpoint de subida más abajo.
• autoPublishOnApproval inscribe esta factura en la auto-publicación cuando la orden de trabajo se completa.
• Guardar una factura puede transicionar el estado de la orden de trabajo asociada según el mapeo de estado factura-a-orden. Un fallo de validación a nivel de guardado devuelve 406.
• Pasar un id actualiza una factura existente (solo borradores, en la práctica; los estados del lado del comprador no son tuyos para editar).

​

Sube el PDF y publica

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"

​

Leer y conciliar

​

Flujo de facturación de extremo a extremo

1. La orden de trabajo llega a cotización: envía una propuesta y espera awarded.
2. Completa el trabajo mediante el check-out de la llamada de servicio.
3. Crea la factura en borrador; genera tu PDF.
4. Una vez que la orden de trabajo aparezca como Completed, upload_and_publish.
5. Consulta el estado de la factura por sondeo hasta paid, y concilia contra markedPaidAt.