SoftCo iPaaS · Integration Reference

Developer
Portal

Connect your ERP to SoftCo's AP platform using our REST API suite. Push master data, purchase orders, goods receipts, and payment confirmations — all asynchronously, all in minutes.

7
APIs
202
Async Response
Live
Sandbox
REST
Protocol
JSON over HTTPS
All requests send application/Json payloads to a single POST endpoint per API.
Async · 202 Accepted
Every API returns 202 immediately. Records are queued and delivered to SoftCo AP within minutes.
Authentication
Supports the authentication method that best suits your needs, including OAuth 2.0, JWT, API Keys, or Basic Authentication.
Idempotent Resending
Resubmitting any record with the same primary key refreshes the existing record — no duplicates created.

Reference data your AP platform
needs to process invoices

Keep SoftCo's supplier master, GL chart of accounts, cost centres, and item catalogue in sync with your ERP. These APIs underpin correct invoice coding and matching.

Master Data
Vendor Data

Create and maintain supplier records in SoftCo. Includes vendor identity, contact details, address, payment terms, and bank account information. The supplier code must match what your ERP sends on purchase orders and GRNs.

POST /vendor-data/v1
Required: organization, code, name Bank accounts supported
Master Data
Accounting Objects

Push cost centres, departments, projects, and other accounting dimensions to SoftCo. These values are used to classify and code invoices. Supports multilingual descriptions for international deployments.

POST /accounting-objects/v1
Required: organization, code, description_en Multilingual labels
Master Data
General Ledger Account Codes

Synchronise your chart of accounts with SoftCo. GL codes are used when coding invoices for posting. Supports DEDUCTABLE and VAT types, tax codes, and optional product group classification.

POST /general-ledger-codes/v1
Required: organization, code, type, description_en
Master Data
Non-Inventory Items

Maintain a catalogue of non-stock items — services, subscriptions, and recurring expenses — that can be selected when creating purchase orders in SoftCo. Supports tax codes and product grouping.

POST /non-inventory-items/v1
Required: organization, code, type, description_en

Live transaction feeds that power
automated invoice matching

Push purchase orders, goods receipts, and payment confirmations from your ERP in real time. SoftCo uses these to validate and match supplier invoices automatically.

Transaction Data
Purchase Orders

Send committed purchase orders to SoftCo for PO-based invoice matching. Each PO line carries pricing, quantity, GL coding, and a receipting flag that controls whether a GRN is required before invoice approval.

POST /purchase-orders/v1
POST /purchase-orders/v2 Unified
2-way & 3-way matching Batch supported
Transaction Data
Goods Received

Submit goods receipt notes (GRNs) when physical deliveries arrive. SoftCo uses GRN data for three-way matching: PO → GRN → invoice. Each line carries its own PO reference, allowing a single GRN to span multiple purchase orders.

POST /goods-received/v1
POST /goods_received/v2 Unified
3-way matching Batch supported
Transaction Data
Payment Confirmation

Confirm payment status back to SoftCo after your ERP processes a payment run. Links the SoftCo case ID to your voucher and payment references, closing the AP cycle and marking invoices as paid.

POST /payment-confirmation/v1
Closes AP cycle

Built for integration teams

Every API follows the same patterns — one endpoint, one method, one envelope structure. Learn it once and apply it across all seven.

01
Wrap your payload in the standard envelope

All APIs use the same outer JSON structure. Your records sit inside objects.object.record as an array — allowing single or batch submission in one call.

{"objects": {"object": {"record": [
  { ...your record... }
]}}}
02
Authenticate with a single header

Pass your API key in the X-Api-Key header on every request. Additional authentication mechanisms (OAuth 2.0, mTLS) are available and can be enabled during onboarding.

X-Api-Key: <your-api-key>
Content-Type: application/Json
03
Receive 202 — SoftCo queues the rest

Every successful submission returns 202 Accepted immediately. Your record is queued and delivered to SoftCo AP asynchronously — typically within minutes. Resending is always safe.

{"status_code": "202",
 "status_message": "success"}
Sandbox Quick Start

Keyless sandbox.
Ready to test in seconds.

The sandbox environment uses mocked interfaces. Every API documentation page includes a Try it now console — just open any API page, click the orange button, fill in the form, and hit Send. No setup required.

cURL example
# Example: push a vendor record
curl -X POST \
  -H "Content-Type: application/Json" \
  -H "X-Api-Key: <your-api-key>" \
  -d '{"objects":{"object":{"record":[
      {"organization":"main","code":"SUP-001",
      "name":"Acme Supplies Ltd"}
  ]}}}' \
  https://apigw.ipaas.softco.com/vendor-data/v1