Makini
v4 (Latest)
  • v4 (Latest)
  • v3 (Legacy)
User GuideAPI ReferenceMCPPlatforms
User GuideAPI ReferenceMCPPlatforms
Website
v4 (Latest)
  • v4 (Latest)
  • v3 (Legacy)
v4 (Latest)
  • v4 (Latest)
  • v3 (Legacy)
  1. EDI X12
  • Coupa
    • Connecting Coupa
  • CorrigoPro
    • Connecting CorrigoPro
    • Supported data
  • Amazon PayeeCentral
    • Connecting Amazon PayeeCentral
    • Supported data
  • Antero
    • Connecting Antero
    • Supported data
  • Asset Essentials
    • Connecting Asset Essentials
    • Supported data
  • Cityworks
    • Connecting Cityworks
    • Supported data
  • DELMIA Works
    • Connecting DELMIA Works
    • Supported data
  • Dynamics 365 Business Central
    • Connecting Dynamics 365 Business Central
    • Supported data
  • Dynamics 365 Finance & Operations
    • Connecting Dynamics 365 Finance & Operations
    • Supported data
  • EDI X12
    • Connecting EDI X12
    • Supported data
  • eMaint X4
    • Connecting eMaint X4
    • Supported data
  • Fishbowl Advanced
    • Connecting Fishbowl Advanced
    • Supported data
  • Fleetio
    • Connecting Fleetio
    • Supported data
  • FuelMaster
    • Connecting FuelMaster
    • Supported data
  • Geotab
    • Connecting Geotab
    • Supported data
  • Inextia
    • Connecting Inextia
    • Supported data
  • JD Edwards EnterpriseOne
    • Connecting JD Edwards EnterpriseOne
    • Supported data
  • MaintainX
    • Connecting MaintainX
    • Supported data
  • Mitti
    • Connecting Mitti
    • Supported data
  • OPTIME
    • Connecting OPTIME
    • Supported data
  • Oracle E-Business Suite
    • Connecting Oracle E-Business Suite
    • Supported data
  • Oracle Primavera P6 EPPM
    • Connecting Oracle Primavera P6 EPPM
    • Supported data
  • Ordoro
    • Connecting Ordoro
    • Supported data
  • PeopleSoft FSCM
    • Connecting PeopleSoft FSCM
    • Supported data
  • PubWorks
    • Connecting PubWorks
    • Supported data
  • Salesforce
    • Connecting Salesforce
    • Supported data
  • SAP
    • Connecting SAP
    • Supported data
  • Sensus Analytics
    • Connecting Sensus Analytics
    • Supported data
  • ServiceNow
    • Connecting ServiceNow
    • Supported data
  • StarRez
    • Connecting StarRez
    • Supported data
  • UpKeep
    • Connecting UpKeep
    • Supported data
  1. EDI X12

Connecting EDI X12

This guide walks you through connecting a trading partner that exchanges EDI X12 documents with you. Once connected, the documents your partner sends arrive as orders, shipments and invoices, and the ones you create are sent to your partner as X12.
Set aside about 10 minutes. You'll need your ISA qualifier and ID, your trading partner's ISA qualifier and ID, and a contact at your partner who can point their EDI system at a new address.

How it works#

Each connection is one trading partner. It gets an inbox of its own, and your partner delivers documents to that inbox and collects yours from it. Connect each partner separately, so their documents never mix.
DocumentWhen your partner sends itWhen you send it
850 Purchase OrderA sales orderA purchase order
855 Purchase Order AcknowledgmentThe status of your purchase orderThe status of their order
856 Ship NoticeAn expected receiptA shipment
810 InvoiceAn invoice to payAn invoice to collect
997 Functional AcknowledgmentMarks your document as acceptedSent for you, for every document received

Which way should you connect?#

SFTP inbox
Your partner's EDI system uploads files to a folder and downloads yours from another. This is what most EDI systems and VANs expect. Choose it unless your partner asks for email.
Email inbox
Your partner sends documents as email attachments and receives yours the same way. Choose it when your partner has no SFTP client.

Before you start#

Agree these with your trading partner. They are the same values both sides put on every document.
Your ISA qualifier and Your ISA ID: how you are identified on the envelope. The qualifier is two characters, most often ZZ, 01 (D-U-N-S) or 12 (phone number). The ID is up to 15 characters.
Partner ISA qualifier and Partner ISA ID: the same two values for your partner.
X12 version: 4010 or 5010.
Environment: Test while you and your partner are trying things out, Production when the documents are real.

Option A: Connect with an SFTP inbox#

Step 1: Decide how your partner signs in#

Your partner signs in with a password, an SSH key, or either one.
Password: make one up, at least 8 characters, and keep it in a password manager. You'll give it to your partner in Step 3.
SSH key: ask your partner for their public key. It is one line that starts with ssh-ed25519, ssh-rsa or ecdsa-sha2.

Step 2: Enter the details#

Choose SFTP inbox as the connection method, then fill in:
SFTP password for your partner, Partner's SSH public key, or both
Your company name and Trading partner name
Your ISA qualifier and Your ISA ID
Partner ISA qualifier and Partner ISA ID
X12 version and Environment
Click Connect.

Step 3: Give your partner the address#

Open the connection in Makini. The SFTP inbox card shows the Host, Port and Username; each has a copy button. The same details are under Inbox address in the connection's menu.
Send your partner those three values, plus the password if you set one. They upload documents to /inbox and download yours from /outbox.
Send the password separately from the address, and not by email. Anyone with both can deliver documents in your partner's name.

Option B: Connect with an email inbox#

Step 1: Find out where your partner sends from#

Ask your partner for the email address their EDI system sends from. That is Partner's email address, and it is also where your documents are sent. If they send from more than one address, note the others too.
Mail is accepted only from the addresses you list, and only when it really comes from your partner's mail system.

Step 2: Enter the details#

Choose Email inbox as the connection method, then fill in:
Partner's email address
Other addresses your partner sends from, comma-separated, if there are any
Your company name and Trading partner name
Your ISA qualifier and Your ISA ID
Partner ISA qualifier and Partner ISA ID
X12 version and Environment
Click Connect.

Step 3: Give your partner the address#

Open the connection in Makini. The Email inbox card shows the address to send documents to. Give it to your partner.
Each document travels as an attachment, one document per file. Your documents arrive at your partner's address from that same inbox address, so replies and new documents go to one place.

Keeping it working#

Things that will stop documents arriving
Your partner's sending address changes: add the new one on the connection
The SFTP password is changed on one side only: set the new password on the connection and give it to your partner
Either side changes its ISA qualifier or ID: update the connection so both sides still match
Moving from test to production
Change Environment to Production on the connection when you and your partner are ready. The inbox address stays the same.

If something goes wrong#

A field is marked when I click Connect.
My partner can't sign in over SFTP.
My partner's email was refused.
A document arrived but I don't see an order or invoice.
Still stuck?
Send us a note with the connection's name and what your partner sees. Don't include the SFTP password in that message.
Modified at 2026-10-16 14:20:21
Previous
Supported data
Next
Supported data
Built with