Connect Bluechip Infotech
Bluechip Infotech is an Australian IT distributor. Resellers who hold a Bluechip account can order through Bluechip's EDI REST API instead of its web portal, and StackJack connects an AI assistant to…
Written By Christopher Scaminaci
Last updated 22 days ago
Bluechip Infotech is an Australian IT distributor. Resellers who hold a Bluechip account can order through Bluechip's EDI REST API instead of its web portal, and StackJack connects an AI assistant to that API: stock levels, freight quotes, purchase orders and sales invoices.
Connecting Bluechip to StackJack gives your AI assistant a family of bluechip_ MCP tools. MCP (Model Context Protocol) tools are
the standardized commands an AI assistant can call through StackJack. With them, your AI can:
- Check stock - the stock on hand of a SKU in Bluechip's New South Wales, Victoria and Western Australia warehouses, in real time
- Quote freight - the carrier options, lead days and prices in Australian dollars for a shipment from one of those warehouses
- Read sales invoices - the invoices of the last seven days, and one invoice in full: entities, lines, tax, totals, serial numbers and MAC addresses, and the carrier and shipping reference
- See the document shapes - Bluechip's own example freight query and example purchase order
- Place and change orders (on Pro plans) - submit a customer purchase order, and update one that Bluechip has not yet released to its warehouse for picking
How StackJack authenticates to Bluechip
Bluechip uses an EDI partner username and password. Bluechip issues them when it registers your account as an EDI partner. They are not your Bluechip web login. The address is fixed, so there is no URL to enter, and StackJack sends the login only to Bluechip's API address, only over HTTPS.
Getting the username and password
- Ask your Bluechip account manager for API access, and complete Bluechip's API onboarding application. Bluechip asks for your customer account number and how you will use the API.
- Bluechip registers you as an EDI partner and sends you the username and password.
- A new login starts in TEST mode and works for real orders only after Bluechip approves it for production. Ask Bluechip which mode your login is in.
Connect it in StackJack
- Open Connectors, then Bluechip Infotech.
- Enter the username in EDI partner username and the password in EDI partner password. A username cannot contain a colon.
- Click Test connection. StackJack reads Bluechip's example freight query to prove the login works, and changes nothing.
Enter both again whenever you save the connection, including when you only rename it.
What is worth knowing before you start
Purchase order tools place and change real orders
Submitting or updating a customer purchase order commits your account to buy. Both tools are on the Pro tier, are marked destructive, and ask for approval before they run. Everything else on this connector only reads, or asks for a price, and is on the Free tier. A freight quote is a request for a price: nothing is booked and no order is created, so it is safe to repeat.
Check the lines, prices and the ship-to address with the person who asked before an order is submitted, and use the stock and freight tools first. Stock is not reserved when you check it, so an order can still find the stock gone.
Sending an order again after a timeout
Every purchase order call carries a PayloadID, which Bluechip uses once. Bluechip also refuses a customer purchase order number it has already received. So if a submission gets no answer, send it again with the same PayloadID: Bluechip will not create the order twice. If Bluechip answers that the PayloadID already exists, the first attempt arrived, so check the order with Bluechip before submitting it a third time.
If you leave the PayloadID out, StackJack makes one from the time (in UTC) and your purchase order number.
An update is not always possible
Bluechip accepts a change to an order only until the order is released to its warehouse for picking, and it says that an update may not always be possible. A refusal leaves the order as it was.
Bluechip's answers, and how errors are shown
Every Bluechip answer is wrapped as Code, Status and Detail. StackJack hands you that answer as Bluechip sent it. Bluechip can
report a failure inside an answer that otherwise looks successful, and it sometimes numbers a failure differently from its own
wording (a missing SKU can arrive numbered 401 beside the words "Bad Request"). StackJack reads both, reports the failure as an
error with Bluechip's own words, and does not treat a missing SKU as a wrong password.
When Bluechip refuses a call
- The username or password is rejected: the login is wrong or was changed. Ask Bluechip to confirm the username and password of your EDI partner account, and enter both again.
- The account is not allowed to do that: Bluechip answers "not authorized to view/submit this document" when your partner account may not use a document or action. A login still in TEST mode, or not yet approved for ordering, is refused some actions. This is not a wrong password and is not counted against the connection. Ask Bluechip to enable the action for your account.
- A SKU or invoice is not found: check the SKU against Bluechip's own SKU or the manufacturer's part number, and get an invoice id from the invoice list. The list covers only the last seven days.
- Bluechip rejects the purchase order: its message names each problem, such as a SKU it does not know. Correct the document and send it again. Nothing was ordered.
- Bluechip could not read the document: the purchase order is not valid JSON, or a value has the wrong type. Compare it with the example purchase order and correct it.
- A gateway refuses the request: if something in front of Bluechip answers 403 with something that is not a Bluechip answer, it is not a wrong password. If Bluechip restricts its API to known addresses, open a StackJack support ticket for the addresses to give Bluechip.
If Bluechip does not answer properly while an order is being sent, check the order with Bluechip before you repeat it, and send the same PayloadID when you do.
What this connector does not do
Bluechip can also send order status updates to a server you run (its Sales Order Status Update callback). StackJack does not receive those. To follow an order, list its sales invoices and read each one.
Bluechip documents no rate limit, so StackJack keeps its own pace and backs off when Bluechip asks it to slow down. The purchase order document is sent as JSON; Bluechip's XML form is not offered.
Plans and limits
Reads are available on the Free tier. Submitting and updating a purchase order are Pro. Business reaches the same tools as Pro and differs by monthly call quota.
See the generated Bluechip Infotech tool reference for the current inventory, plan assignment, input schemas, and destructive-action labels.
Bluechip Infotech tools
bluechip_ · 9 tools · Free 7 · Pro 2
Stock
Freight
Purchase orders
Sales invoices
Was this helpful?
More in Connector guides
Connect 3CXConnect AbleSignConnect Acronis Cyber Protect CloudConnect Action1Still need help? Ask the team