/sales-orders/meta/post

Beta

GET

/accounting/v1/sales-orders/meta/post

GET

/api/accounting/v1/sales-orders/meta/post

1 curl https://api.merge.dev/api/accounting/v1/sales-orders/meta/post \
2      -H "X-Account-Token: X-Account-Token" \
3      -H "Authorization: Bearer <token>"

200Retrieved

1 {
2   "request_schema": {
3     "type": "object",
4     "properties": {
5       "model": {
6         "type": "object",
7         "required": [
8           "last_name",
9           "first_name",
10           "merge_categories",
11           "new_york_city_neighborhood",
12           "favorite_tv_shows",
13           "favorite_watch"
14         ],
15         "properties": {
16           "email_addresses": {
17             "type": "array",
18             "items": {
19               "type": "object",
20               "properties": {
21                 "value": {
22                   "type": "string",
23                   "title": "value"
24                 },
25                 "email_address_type": {
26                   "type": "string",
27                   "title": "email_address_type"
28                 },
29                 "integration_params": {
30                   "type": "object",
31                   "title": "integration_params",
32                   "properties": {}
33                 },
34                 "linked_account_params": {
35                   "type": "object",
36                   "title": "linked_account_params",
37                   "properties": {}
38                 }
39               }
40             },
41             "title": "email_addresses",
42             "description": "Array of email_addresses objects"
43           },
44           "urls": {
45             "type": "array",
46             "items": {
47               "type": "object",
48               "properties": {
49                 "value": {
50                   "type": "string",
51                   "title": "value"
52                 },
53                 "url_type": {
54                   "type": "string",
55                   "title": "url_type"
56                 },
57                 "integration_params": {
58                   "type": "object",
59                   "title": "integration_params",
60                   "properties": {}
61                 },
62                 "linked_account_params": {
63                   "type": "object",
64                   "title": "linked_account_params",
65                   "properties": {}
66                 }
67               }
68             },
69             "title": "urls",
70             "description": "Array of urls objects"
71           },
72           "first_name": {
73             "type": "string",
74             "title": "first_name",
75             "description": "The first name."
76           },
77           "last_name": {
78             "type": "string",
79             "title": "last_name",
80             "description": "The last name."
81           },
82           "phone_numbers": {
83             "type": "array",
84             "items": {
85               "type": "object",
86               "properties": {
87                 "value": {
88                   "type": "string",
89                   "title": "value"
90                 },
91                 "phone_number_type": {
92                   "type": "string",
93                   "title": "phone_number_type"
94                 },
95                 "integration_params": {
96                   "type": "object",
97                   "title": "integration_params",
98                   "properties": {}
99                 },
100                 "linked_account_params": {
101                   "type": "object",
102                   "title": "linked_account_params",
103                   "properties": {}
104                 }
105               }
106             },
107             "title": "phone_numbers",
108             "description": "Array of phone_numbers objects"
109           },
110           "tags": {
111             "type": "array",
112             "items": {
113               "type": "string",
114               "format": "uuid"
115             },
116             "title": "tags",
117             "description": "Array of tags names"
118           },
119           "attachments": {
120             "type": "array",
121             "items": {
122               "type": "object",
123               "properties": {
124                 "id": {
125                   "type": "string",
126                   "title": "id"
127                 },
128                 "file_url": {
129                   "type": "string",
130                   "title": "file_url"
131                 },
132                 "file_name": {
133                   "type": "string",
134                   "title": "file_name"
135                 },
136                 "attachment_type": {
137                   "type": "string",
138                   "title": "attachment_type"
139                 },
140                 "integration_params": {
141                   "type": "object",
142                   "title": "integration_params",
143                   "properties": {}
144                 },
145                 "linked_account_params": {
146                   "type": "object",
147                   "title": "linked_account_params",
148                   "properties": {}
149                 }
150               }
151             },
152             "title": "attachments",
153             "description": "Array of attachments objects "
154           },
155           "merge_categories": {
156             "type": "array",
157             "categories": {
158               "type": "string",
159               "enum": [
160                 "HRIS",
161                 "ATS",
162                 "Accounting",
163                 "Ticketing",
164                 "File Storage",
165                 "CRM",
166                 "Marketing Automation"
167               ],
168               "enum_information": [
169                 {
170                   "value": "HRIS",
171                   "description": "Merge HRIS Category"
172                 },
173                 {
174                   "value": "ATS",
175                   "description": "Merge ATS Category"
176                 },
177                 {
178                   "value": "Accounting",
179                   "description": "Merge Accounting Category"
180                 },
181                 {
182                   "value": "Ticketing",
183                   "description": "Merge Ticketing Category"
184                 },
185                 {
186                   "value": "File Storage",
187                   "description": "Merge File Storage Category"
188                 },
189                 {
190                   "value": "CRM",
191                   "description": "Merge CRM Category"
192                 },
193                 {
194                   "value": "Marketing Automation",
195                   "description": "Merge Marketing Automation Category"
196                 }
197               ]
198             },
199             "title": "Merge Categories",
200             "description": "Array of Merge's Unified API Categories"
201           },
202           "new_york_city_neighborhood": {
203             "type": "string",
204             "title": "Borough",
205             "description": "One of the 5 Boroughs of New York City"
206           },
207           "favorite_tv_shows": {
208             "type": "array",
209             "items": {
210               "type": "string",
211               "format": "uuid"
212             },
213             "title": "Favorite TV Shows",
214             "description": "Array of TV Show objects on merge.tv_shows"
215           },
216           "favorite_watch": {
217             "type": "string",
218             "title": "Favorite Watch",
219             "description": "Favorite watch of all time"
220           }
221         }
222       }
223     }
224   },
225   "has_conditional_params": true,
226   "has_required_linked_account_params": true,
227   "status": {
228     "linked_account_status": "COMPLETE",
229     "can_make_request": true
230   }
231 }

Returns metadata for SalesOrder POSTs.

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Headers

X-Account-TokenstringRequired

Token identifying the end user.

Response

request_schemamap from strings to any

has_conditional_paramsboolean

has_required_linked_account_paramsboolean

statusobject or null

remote_fieldslist of strings or null

Remote field values to populate

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

customerstring or nullOptionalformat: "uuid"

The customer associated with the sales order.

currencyenum or nullOptional

The currency code for the order.

XUA - ADB Unit of Account
AFN - Afghan Afghani
AFA - Afghan Afghani (1927–2002)
ALL - Albanian Lek
ALK - Albanian Lek (1946–1965)
DZD - Algerian Dinar
ADP - Andorran Peseta
AOA - Angolan Kwanza
AOK - Angolan Kwanza (1977–1991)
AON - Angolan New Kwanza (1990–2000)
AOR - Angolan Readjusted Kwanza (1995–1999)
ARA - Argentine Austral
ARS - Argentine Peso
ARM - Argentine Peso (1881–1970)
ARP - Argentine Peso (1983–1985)
ARL - Argentine Peso Ley (1970–1983)
AMD - Armenian Dram
AWG - Aruban Florin
AUD - Australian Dollar
ATS - Austrian Schilling
AZN - Azerbaijani Manat
AZM - Azerbaijani Manat (1993–2006)
BSD - Bahamian Dollar
BHD - Bahraini Dinar
BDT - Bangladeshi Taka
BBD - Barbadian Dollar
BYN - Belarusian Ruble
BYB - Belarusian Ruble (1994–1999)
BYR - Belarusian Ruble (2000–2016)
BEF - Belgian Franc
BEC - Belgian Franc (convertible)
BEL - Belgian Franc (financial)
BZD - Belize Dollar
BMD - Bermudan Dollar
BTN - Bhutanese Ngultrum
BOB - Bolivian Boliviano
BOL - Bolivian Boliviano (1863–1963)
BOV - Bolivian Mvdol
BOP - Bolivian Peso
BAM - Bosnia-Herzegovina Convertible Mark
BAD - Bosnia-Herzegovina Dinar (1992–1994)
BAN - Bosnia-Herzegovina New Dinar (1994–1997)
BWP - Botswanan Pula
BRC - Brazilian Cruzado (1986–1989)
BRZ - Brazilian Cruzeiro (1942–1967)
BRE - Brazilian Cruzeiro (1990–1993)
BRR - Brazilian Cruzeiro (1993–1994)
BRN - Brazilian New Cruzado (1989–1990)
BRB - Brazilian New Cruzeiro (1967–1986)
BRL - Brazilian Real
GBP - British Pound
BND - Brunei Dollar
BGL - Bulgarian Hard Lev
BGN - Bulgarian Lev
BGO - Bulgarian Lev (1879–1952)
BGM - Bulgarian Socialist Lev
BUK - Burmese Kyat
BIF - Burundian Franc
XPF - CFP Franc
KHR - Cambodian Riel
CAD - Canadian Dollar
CVE - Cape Verdean Escudo
KYD - Cayman Islands Dollar
XAF - Central African CFA Franc
CLE - Chilean Escudo
CLP - Chilean Peso
CLF - Chilean Unit of Account (UF)
CNX - Chinese People’s Bank Dollar
CNY - Chinese Yuan
CNH - Chinese Yuan (offshore)
COP - Colombian Peso
COU - Colombian Real Value Unit
KMF - Comorian Franc
CDF - Congolese Franc
CRC - Costa Rican Colón
HRD - Croatian Dinar
HRK - Croatian Kuna
CUC - Cuban Convertible Peso
CUP - Cuban Peso
CYP - Cypriot Pound
CZK - Czech Koruna
CSK - Czechoslovak Hard Koruna
DKK - Danish Krone
DJF - Djiboutian Franc
DOP - Dominican Peso
NLG - Dutch Guilder
XCD - East Caribbean Dollar
DDM - East German Mark
ECS - Ecuadorian Sucre
ECV - Ecuadorian Unit of Constant Value
EGP - Egyptian Pound
GQE - Equatorial Guinean Ekwele
ERN - Eritrean Nakfa
EEK - Estonian Kroon
ETB - Ethiopian Birr
EUR - Euro
XBA - European Composite Unit
XEU - European Currency Unit
XBB - European Monetary Unit
XBC - European Unit of Account (XBC)
XBD - European Unit of Account (XBD)
FKP - Falkland Islands Pound
FJD - Fijian Dollar
FIM - Finnish Markka
FRF - French Franc
XFO - French Gold Franc
XFU - French UIC-Franc
GMD - Gambian Dalasi
GEK - Georgian Kupon Larit
GEL - Georgian Lari
DEM - German Mark
GHS - Ghanaian Cedi
GHC - Ghanaian Cedi (1979–2007)
GIP - Gibraltar Pound
XAU - Gold
GRD - Greek Drachma
GTQ - Guatemalan Quetzal
GWP - Guinea-Bissau Peso
GNF - Guinean Franc
GNS - Guinean Syli
GYD - Guyanaese Dollar
HTG - Haitian Gourde
HNL - Honduran Lempira
HKD - Hong Kong Dollar
HUF - Hungarian Forint
IMP - IMP
ISK - Icelandic Króna
ISJ - Icelandic Króna (1918–1981)
INR - Indian Rupee
IDR - Indonesian Rupiah
IRR - Iranian Rial
IQD - Iraqi Dinar
IEP - Irish Pound
ILS - Israeli New Shekel
ILP - Israeli Pound
ILR - Israeli Shekel (1980–1985)
ITL - Italian Lira
JMD - Jamaican Dollar
JPY - Japanese Yen
JOD - Jordanian Dinar
KZT - Kazakhstani Tenge
KES - Kenyan Shilling
KWD - Kuwaiti Dinar
KGS - Kyrgystani Som
LAK - Laotian Kip
LVL - Latvian Lats
LVR - Latvian Ruble
LBP - Lebanese Pound
LSL - Lesotho Loti
LRD - Liberian Dollar
LYD - Libyan Dinar
LTL - Lithuanian Litas
LTT - Lithuanian Talonas
LUL - Luxembourg Financial Franc
LUC - Luxembourgian Convertible Franc
LUF - Luxembourgian Franc
MOP - Macanese Pataca
MKD - Macedonian Denar
MKN - Macedonian Denar (1992–1993)
MGA - Malagasy Ariary
MGF - Malagasy Franc
MWK - Malawian Kwacha
MYR - Malaysian Ringgit
MVR - Maldivian Rufiyaa
MVP - Maldivian Rupee (1947–1981)
MLF - Malian Franc
MTL - Maltese Lira
MTP - Maltese Pound
MRU - Mauritanian Ouguiya
MRO - Mauritanian Ouguiya (1973–2017)
MUR - Mauritian Rupee
MXV - Mexican Investment Unit
MXN - Mexican Peso
MXP - Mexican Silver Peso (1861–1992)
MDC - Moldovan Cupon
MDL - Moldovan Leu
MCF - Monegasque Franc
MNT - Mongolian Tugrik
MAD - Moroccan Dirham
MAF - Moroccan Franc
MZE - Mozambican Escudo
MZN - Mozambican Metical
MZM - Mozambican Metical (1980–2006)
MMK - Myanmar Kyat
NAD - Namibian Dollar
NPR - Nepalese Rupee
ANG - Netherlands Antillean Guilder
TWD - New Taiwan Dollar
NZD - New Zealand Dollar
NIO - Nicaraguan Córdoba
NIC - Nicaraguan Córdoba (1988–1991)
NGN - Nigerian Naira
KPW - North Korean Won
NOK - Norwegian Krone
OMR - Omani Rial
PKR - Pakistani Rupee
XPD - Palladium
PAB - Panamanian Balboa
PGK - Papua New Guinean Kina
PYG - Paraguayan Guarani
PEI - Peruvian Inti
PEN - Peruvian Sol
PES - Peruvian Sol (1863–1965)
PHP - Philippine Peso
XPT - Platinum
PLN - Polish Zloty
PLZ - Polish Zloty (1950–1995)
PTE - Portuguese Escudo
GWE - Portuguese Guinea Escudo
QAR - Qatari Rial
XRE - RINET Funds
RHD - Rhodesian Dollar
RON - Romanian Leu
ROL - Romanian Leu (1952–2006)
RUB - Russian Ruble
RUR - Russian Ruble (1991–1998)
RWF - Rwandan Franc
SVC - Salvadoran Colón
WST - Samoan Tala
SAR - Saudi Riyal
RSD - Serbian Dinar
CSD - Serbian Dinar (2002–2006)
SCR - Seychellois Rupee
SLL - Sierra Leonean Leone
XAG - Silver
SGD - Singapore Dollar
SKK - Slovak Koruna
SIT - Slovenian Tolar
SBD - Solomon Islands Dollar
SOS - Somali Shilling
ZAR - South African Rand
ZAL - South African Rand (financial)
KRH - South Korean Hwan (1953–1962)
KRW - South Korean Won
KRO - South Korean Won (1945–1953)
SSP - South Sudanese Pound
SUR - Soviet Rouble
ESP - Spanish Peseta
ESA - Spanish Peseta (A account)
ESB - Spanish Peseta (convertible account)
XDR - Special Drawing Rights
LKR - Sri Lankan Rupee
SHP - St. Helena Pound
XSU - Sucre
SDD - Sudanese Dinar (1992–2007)
SDG - Sudanese Pound
SDP - Sudanese Pound (1957–1998)
SRD - Surinamese Dollar
SRG - Surinamese Guilder
SZL - Swazi Lilangeni
SEK - Swedish Krona
CHF - Swiss Franc
SYP - Syrian Pound
STN - São Tomé & Príncipe Dobra
STD - São Tomé & Príncipe Dobra (1977–2017)
TVD - TVD
TJR - Tajikistani Ruble
TJS - Tajikistani Somoni
TZS - Tanzanian Shilling
XTS - Testing Currency Code
THB - Thai Baht
XXX - The codes assigned for transactions where no currency is involved
TPE - Timorese Escudo
TOP - Tongan Paʻanga
TTD - Trinidad & Tobago Dollar
TND - Tunisian Dinar
TRY - Turkish Lira
TRL - Turkish Lira (1922–2005)
TMT - Turkmenistani Manat
TMM - Turkmenistani Manat (1993–2009)
USD - US Dollar
USN - US Dollar (Next day)
USS - US Dollar (Same day)
UGX - Ugandan Shilling
UGS - Ugandan Shilling (1966–1987)
UAH - Ukrainian Hryvnia
UAK - Ukrainian Karbovanets
AED - United Arab Emirates Dirham
UYW - Uruguayan Nominal Wage Index Unit
UYU - Uruguayan Peso
UYP - Uruguayan Peso (1975–1993)
UYI - Uruguayan Peso (Indexed Units)
UZS - Uzbekistani Som
VUV - Vanuatu Vatu
VES - Venezuelan Bolívar
VEB - Venezuelan Bolívar (1871–2008)
VEF - Venezuelan Bolívar (2008–2018)
VND - Vietnamese Dong
VNN - Vietnamese Dong (1978–1985)
CHE - WIR Euro
CHW - WIR Franc
XOF - West African CFA Franc
YDD - Yemeni Dinar
YER - Yemeni Rial
YUN - Yugoslavian Convertible Dinar (1990–1992)
YUD - Yugoslavian Hard Dinar (1966–1990)
YUM - Yugoslavian New Dinar (1994–2002)
YUR - Yugoslavian Reformed Dinar (1992–1993)
ZWN - ZWN
ZRN - Zairean New Zaire (1993–1998)
ZRZ - Zairean Zaire (1971–1993)
ZMW - Zambian Kwacha
ZMK - Zambian Kwacha (1968–2012)
ZWD - Zimbabwean Dollar (1980–2008)
ZWR - Zimbabwean Dollar (2008)
ZWL - Zimbabwean Dollar (2009)

exchange_ratestring or nullOptionalformat: "decimal"

The exchange rate applied if the order currency differs from the base currency.

companystring or nullOptionalformat: "uuid"

The subsidiary associated with the order.

statusenum or nullOptional

The status of the sales order.

DRAFT - DRAFT
PENDING_APPROVAL - PENDING_APPROVAL
OPEN - OPEN
PARTIALLY_COMPLETED - PARTIALLY_COMPLETED
COMPLETED - COMPLETED
CLOSED - CLOSED

payment_termstring or nullOptionalformat: "uuid"

The payment terms applied to this order.

memostring or nullOptional

Notes or comments attached to the order.

shipping_addressstring or nullOptionalformat: "uuid"

The shipping address for the order.

tracking_categorieslist of stringsOptional

issue_datedatetime or nullOptional

The date the sales order was issued.

transaction_numberstring or nullOptional

The human-readable sales order number or transaction reference.

totaldouble or nullOptional

Total amount of order.

lineslist of objectsOptionalRead-only

remote_created_atdatetime or nullOptional

When the third party's sales order was created.

remote_updated_atdatetime or nullOptional

When the third party's sales order was updated.

remote_datalist of objects or nullOptionalRead-only