My Clients

How to create, link, and manage the business accounts you work with as a developer on x12port. Available at /dev/clients — developer accounts only.

What is a Developer Client?

A developer client is a business account you manage on x12port on behalf of one of your customers. Each client has their own EDI identity (ISA Qualifier + ISA ID) and can be linked to trading partner connections, endpoints, and mapping projects you've built for them.

There are two kinds of clients:

TypeWhen to use
Offline Client You manage their EDI entirely — they don't need an x12port login. You create a profile for them with their ISA details and manage everything on their behalf.
Linked Client The business signs up for their own x12port account via your developer invite link. They get their own dashboard; you remain their assigned developer.

Creating an Offline Client

  1. Go to /dev/clients
  2. Click + Add Offline Client
  3. Fill in the client's details:
    • Business Name — the company name
    • ISA Qualifier — the two-character X12 qualifier (e.g. ZZ for mutually defined, 01 for DUNS)
    • ISA ID — the company's unique EDI identifier assigned by their trading partners
    • Contact Email — your point of contact at the client (optional)
  4. Click Save Client

The client now appears in your client list and can be referenced in your mapping projects and endpoint configurations.

Linking a Client via Invite

  1. Find your Developer Link Code on your developer dashboard sidebar
  2. Share it with your client — they enter it when signing up at /signup?type=client
  3. Once they verify their email, they appear in your Dev Clients view automatically
ℹ️ Your developer link code is unique to your account. Any client who signs up through it is automatically associated with you — you don't need to do anything after sharing the code.

Client Detail View

Click any client in your list to open their detail page. From here you can:

  • View/edit EDI identity — update ISA Qualifier and ISA ID if they change
  • See their transaction sets — the X12 document types configured for this client
  • Send a linked-account invite — convert an offline client to a linked account by sending them an invite email
  • Delete the client — removes the offline profile (linked clients must be unlinked from their own account)

Using Clients in Mapping Projects

When building a mapping project in the Visual Mapping GUI, you can associate it with a specific client. This lets you keep each client's mapping rules organised and separated. Saved maps are visible across all your clients, so naming conventions matter — e.g. Acme Corp — 850→JSON Inbound.

ISA Qualifier Reference

QualifierMeaningCommon for
01DUNS NumberLarge manufacturers and retailers
08UCC/EAN Communication IDGrocery and CPG
12Phone NumberSmall trading partners
14DUNS + SuffixMulti-division companies
20Health Industry NumberHealthcare
ZZMutually DefinedMost common — agreed between partners
✨ x12port Assistant
Free AI support • No credits needed
Hi! I’m the x12port AI Assistant. Ask me anything about EDI, your account, or how to use x12port. 👋