Create Or Update Customer

Creates a customer record or updates an existing customer profile and related address information. Use this endpoint when syncing customer master data from ecommerce, CRM, marketplace, or external ERP systems into Xorosoft ERP.

post

Authorizations

AuthorizationstringRequired

Body

Customer create/update payload.

CustomerNamestringOptional

Customer display name.

CustomerNumberstringOptional

Customer number assigned by the external system or Xorosoft ERP.

Emailstring · email · nullableOptional

Customer email address.

Phonestring · nullableOptional

Customer phone number.

CurrencyCodestring · nullableOptional

Customer currency code.

Other propertiesanyOptional

Responses

200

Request processed successfully.

application/json

Standard Xorosoft ERP API response envelope used by most endpoints.

ResultbooleanOptional

True when the operation completed successfully.

MessagestringOptional

Human-readable success or error message.

Pageinteger · nullableOptional

Current page number when paging is enabled.

TotalPagesinteger · nullableOptional

Total page count when paging is enabled.

400

Invalid request, failed validation, or business rule error.

text/plain

401

Missing or invalid private app credentials.

403

Private app does not have permission for this request.

post/api/xerp/customers/export

POST /api/xerp/customers/export HTTP/1.1
Host: res.xorosoft.io
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 430

{
  "CustomerName": "Example Customer",
  "CustomerNumber": "CUST-1001",
  "Email": "[e-mail]",
  "Phone": "555-0100",
  "CurrencyCode": "USD",
  "BillToAddrList": [
    {
      "AddressName": "Billing",
      "Addr": "123 Market Street",
      "City": "San Francisco",
      "State": "CA",
      "Country": "US",
      "PostalZipCode": "94105"
    }
  ],
  "ShipToAddrList": [
    {
      "AddressName": "Shipping",
      "Addr": "123 Market Street",
      "City": "San Francisco",
      "State": "CA",
      "Country": "US",
      "PostalZipCode": "94105"
    }
  ]
}

{
  "Result": true,
  "Message": "Request processed successfully",
  "Data": {}
}