Skip to main content
Connector guides

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

  1. 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.
  2. Bluechip registers you as an EDI partner and sends you the username and password.
  3. 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

  1. Open Connectors, then Bluechip Infotech.
  2. Enter the username in EDI partner username and the password in EDI partner password. A username cannot contain a colon.
  3. 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

ToolWhat it does
bluechip_get_stock_on_hand
Free · Read-only
Gets the stock on hand of one SKU in Bluechip's NSW, VIC and WA warehouses, in real time: BCIT_SKU, Vendor_SKU (the manufacturer's part number), NSW_Qty, VIC_Qty, WA_Qty and Total_Qty.
bluechip_get_stock_on_hand_example
Free · Read-only
Asks Bluechip for an example stock on hand request: it answers the address of a sample lookup, not stock.

Freight

ToolWhat it does
bluechip_get_freight_quote_example
Free · Read-only
Gets an example freight query object (Source, Destination, Street, Suburb, State, Weight, Volume, Value) as Bluechip builds it, to see the shape bluechip_quote_freight sends.
bluechip_quote_freight
Free · Read-only
Quotes the freight for one shipment from a Bluechip warehouse: the carrier options with service code, lead days, zone, cubed weight and the freight amount in AUD.

Purchase orders

ToolWhat it does
bluechip_get_purchase_order_example
Free · Read-only
Gets an example customer purchase order from Bluechip: the document shape bluechip_submit_purchase_order takes (header, ShipTo and EndUser entities, delivery mode, comments, lines with SKU, quantity, unit price and line amount, and the order total).
bluechip_submit_purchase_order
Pro · Destructive
DESTRUCTIVE.
bluechip_update_purchase_order
Pro · Destructive
DESTRUCTIVE.

Sales invoices

ToolWhat it does
bluechip_get_sales_invoice
Free · Read-only
Gets one sales invoice: the billing, shipping and end-user entities, the Bluechip sales order (SalesID) and your purchase order number it answers, payment terms, every line with quantity, unit price, tax and gross amount and its serial numbers and MAC addresses, the totals, and the carrier and shipping reference.
bluechip_list_sales_invoices
Free · Read-only
Lists the account's sales invoices of the last seven days (Bluechip offers no longer window and no filter).