Service unavailable vendor Receipts (503)

Posts about the simPRO API. Help/support/how-to etc.
Forum rules
  • Check the documentation first. Before posting questions, please check the documentation to ensure it doesn't already cover what you need.
  • No spam. All automated messages, advertisements, and links to competitor websites will be deleted immediately.
  • Post in relevant sub-forums only. Messages posted in the wrong topic area will be removed and placed in the correct sub-forum by moderators.
  • Respect other users. No flaming or abusing fellow forum members. Users who continue to post inflammatory, abusive comments will be deleted from the forum after two warnings are issued by moderators.
  • Harassment. No threats or harassment of other users will be tolerated. Any instance of threatening or harassing behavior is grounds for deletion from the forums.
  • Adult content. No profanity or pornography is allowed. Posts containing adult material will be deleted.
  • Bandwidth. All images and signatures must be 500 x 500 pixels or smaller. Posts containing over-sized images and signatures will be removed.
  • Illegal content. No re-posting of copyrighted materials or other illegal content is allowed. Any posts containing illegal content or copyrighted materials will be deleted.
Post Reply
tmeier
Posts: 8
Joined: Fri Aug 15, 2025 4:47 am

Service unavailable vendor Receipts (503)

Post by tmeier » Thu Sep 04, 2025 10:34 am

I'm trying to create a vendor receipt via the published API endpoint

/api/v1.0/companies/{companyID}/vendorOrders/{vendorOrderID}/receipts/

but get this error

Service unavailable - try again later or consider setting this node to retry automatically (in the node settings)
503 - "{\"success\":false,\"errors\":[{\"message\":\"Service Unavailable\",\"code\":503}],\"messages\":[],\"result\":[],\"resultInfo\":[]}"

Full message

503 - "{\"success\":false,\"errors\":[{\"message\":\"Service Unavailable\",\"code\":503}],\"messages\":[],\"result\":[],\"resultInfo\":[]}"

{ "body": "{\"VendorInvoiceNo\":\"INV8611\",\"Notes\":\"Invoice processed automatically via n8n for SO100371.\",\"ExchangeRate\":1,\"DateIssued\":\"2025-08-06\",\"Category\":0,\"TaxAdjustment\":{\"ExTax\":0,\"IncTax\":0},\"FreightTaxCode\":0,\"Freight\":{\"ExTax\":0,\"IncTax\":0},\"Total\":{\"ExTax\":4.34,\"IncTax\":4.78},\"ItemsReceived\":true,\"Catalogs\":[{\"Catalog\":0,\"Qty\":1,\"ExpenseCostCenter\":0,\"UnitPrice\":{\"ExTax\":4.34,\"IncTax\":4.774},\"Total\":{\"ExTax\":4.34,\"IncTax\":4.774}}]}", "headers": { "content-type": "", "accept": "application/json,text/html,application/xhtml+xml,application/xml,text/*;q=0.9, image/*;q=0.8, */*;q=0.7", "Authorization": "**hidden**" }, "method": "POST", "uri": "https://xxxxxxxx.simprosuite.com/api/v1 ... /receipts/", "gzip": true, "rejectUnauthorized": true, "followRedirect": true, "resolveWithFullResponse": true, "followAllRedirects": true, "timeout": 300000, "encoding": null, "json": false, "useStream": true }
NOTE: I can successfully preform GET operations to other endpoints (e.g. https://xxxxxxxx.simpro.prosuite.com/ap ... ors/?Name={{ encodeURIComponent($json.output['Supplier Name']) }}

so my OAuth 2 credentials should be good
SimproAPITeam
Posts: 831
Joined: Wed May 01, 2024 2:31 am

Re: Service unavailable vendor Receipts (503)

Post by SimproAPITeam » Fri Sep 05, 2025 6:03 am

Hi,

If your getting 503, it means you the request didnt complete,

Can you try again at another time ? Also, can you also confirm the response body is correct.

The taxAdjustment is expecting number not an array of ex and inc,

Also only pass inc or ex tax, you dont need to pass both on the single request.

Documentation on the endpoint: https://developer.simprogroup.com/apido ... 3510cb72d8
Simpro API Team | Simpro Software Group
tmeier
Posts: 8
Joined: Fri Aug 15, 2025 4:47 am

Re: Service unavailable vendor Receipts (503)

Post by tmeier » Fri Sep 05, 2025 8:11 am

Txs for getting back.

The issue was the catalog ID which was 0; found this via Postman to get more info. Once I added the catalog ID and cost centre the request was successful.

This raises a general question about the flow:

1 The user creates a PO and I get the vendorOrderID
2 Supplier invoice gets issued
3 The code processes the invoice, assembles the request bode and creates the receipt via the endpoint /api/v1.0/companies/{companyID}/vendorOrders/{vendorOrderID}/receipts/ and the corresponding Request Body. However this request needs the catalog ID. However the catalog ID is not available in /api/v1.0/companies/{companyID}/vendorOrders/{vendorOrderID}. So how do I find the catalog ID in order to complete the request body for the creation of the receipt?

Similarly the cost centre needs a lookup before it can be added to the request body. Are there some code samples available for this overall use case
tmeier
Posts: 8
Joined: Fri Aug 15, 2025 4:47 am

Re: Service unavailable vendor Receipts (503)

Post by tmeier » Wed Sep 10, 2025 7:28 am

Any updates here? I don't know how to find the catalog ID and cost centre and need both to create a receipt via the API endpoint
SimproAPITeam
Posts: 831
Joined: Wed May 01, 2024 2:31 am

Re: Service unavailable vendor Receipts (503)

Post by SimproAPITeam » Fri Sep 12, 2025 5:38 am

Hi tmeier,
The cost centre is available in the vendorOrder endpoint that you have as the assignedTo value.

To get the catalogs related to the vendor order you can use this endpoint to get the full list or detailed info of each item.

Code: Select all

/api/v1.0/companies/{companyID}/vendorOrders/{vendorOrderID}/catalogs/
https://developer.simprogroup.com/apido ... 0bc761a8a3

Regards
Simpro API Team | Simpro Software Group
Post Reply