Organization - JSON Specification

Summary

Use this format to send or receive organizations and companies.
NameDescription
RootThe top level document
AddressA physical location.
AttachmentA file attachment
UserA person with an account on a related system.
OrganizationA company, legal entity, or individual
NativeReferenceNumberA raw reference number value received from a source system. This document is meant to relay a platform's native reference number values in as close to the native format as possible and should not be utilized for any business logic purposes. If a reference number is required for any business logic aside from passing through reference number values, it should be added as an actual property to a canonical document.
RoleThe role that the organization plays in the controlling company's supply chain.
NameData TypeDescriptionRequired
doc_typeStringAlways chainio_purchase_order
organizationsArray<Organization>Array of organizations
versionStringThe version of the specification being used.
NameData TypeDescriptionRequired
address_1StringThe first line of the address.
address_2StringThe second line of the address.
address_typeStringThe type of address represented by this element. Specific types may be defined on a per specification basis
cityStringThe city.
countryStringThe 2-Digit ISO 3166 Alpha-2 Country Code. Like 'US'
country_nameStringThe full name of the country like “United States”
nameStringThe name associated with the address.
phone_numberStringThe contact phone number
postal_codeStringThe postal or ZIP code.
stateStringThe state, province, or administrative division code
state_nameStringThe full name of the state, province, or administrative division.
unlocodeStringThe UN/LOCODE associated with the address. Like 'USCHI'
NameData TypeDescriptionRequired
contentBase64A Base64 encoded string of the file content
created_atDateThe timestamp this document was attached.
created_byUserThe user account / party responsible for adding the attachment.
file_nameStringThe name of the file
file_type_codeStringA short code representing the logical type of file. (You might use 'INV' for an invoice.)
file_type_descriptionStringA descriptive file type like 'Invoice to customer X'
media_typeStringThe Media Type of the file (also known as MIME Type or Content-Type)
memoStringInformation regarding the contents of the file.
privateBooleanIf true, attachment is considered a private attachment.
NameData TypeDescriptionRequired
emailStringUser's email address.
first_nameStringUser's first name.
last_nameStringUser's last name.
usernameStringUser's account in the related system.
NameData TypeDescriptionRequired
addressesArray<Address>Addresses related to the organization.
attachmentsArray<Attachment>Attachments associated with the org.
bond_establishedBooleanDoes the organization have an active bond established?
credit_holdBooleanIs the organization currently on credit hold?
credit_termsStringCredit terms established between organization and the controlling company.
denied_party_screenedStringHas a denied party screening been performed for this organization?
organization_nameStringThe name of the organization
rolesArray<Role>The roles that this organization performs in relation to the company for which the document is being processed.
scac_codeStringThe Standard Alpha Carrier Code for the organization if it is a carrier.
source_system_idStringA unique identifying code from the system of record for this organization.YES
tax_identifierStringOrganization's legal tax identification code.
NameData TypeDescriptionRequired
codeStringA code identifying the type of reference number (ex. EDIREF, PO2, ).
descriptionStringA plain-text description of the reference number code. (ex. "EDI Reference Number", "Secondard PO Number").
valueStringThe reference number value.
value_contextStringProvides additional contextual hints at the type or classification of data present in the reference's value.
NameData TypeDescriptionRequired
typeStringThe role type

Example