Integrations (EDI / connector fabric)
Partner profiles, inbound webhooks, and outbound message outbox for PO, ASN, invoice, and functional acks.
Available under Settings → Integrations (/integrations). Permissions: integrations.profiles.* and integrations.messages.*.
What it is
A company-scoped connector fabric for trading partners — not a certified SAP IDoc / AS2 / VAN product. Partners exchange Orka canonical JSON (optionally wrapped with X12/EDIFACT-style keys such as 856 / 810) over HTTPS.
| Message | Direction | Effect |
|---|---|---|
po | Outbound | Confirmed purchase order pushed to partner endpoint |
po_ack | Inbound | Applies supplier PO acknowledgement |
asn | Inbound | Creates a submitted advance shipment notice |
invoice | Inbound | Creates a draft purchase invoice (by product code) |
invoice | Outbound | Posted sales invoice pushed to partner |
functional_ack | Both | Marks messages acked / failed |
Partner profiles
- Create a profile linked to a Partner.
- Set transport (
webhook,http_poll, ormanual_upload) and outbound endpoint URL for webhook. - Copy the inbound URL (
/api/v1/integrations/inbound/:token) and send partners the shared secret (X-Orka-Integration-SecretorAuthorization: Bearer …). - Default subscriptions are created for PO confirmed, sales invoice posted, and ASN submitted.
Message monitor
Inbound and outbound envelopes show status (received → processing → processed / failed / acked). Failed outbound messages can be retried. Test push sends a functional_ack probe to the partner endpoint.
Related
- Procurement ASNs and portal PO ack: Procurement
- Punchout (cXML/OCI) remains a separate catalog flow on
/procurement/punchout