Sync customers
Request
- Base URL(relative, and it does not resolve against the document’s source URL)
- Auth
- API key in header sessionKey
- or API key in header clientCode
- or API key in header jwt
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
Unix Timestamp of the last successful sync.
the ID of the last record in the previous response. It is the responsibility of the API client to extract this value and use it for the next call.
items to take, default: 20, max: 100000
optionally return total number of records in the X-Total-Count response header
Response
OK
Global Location Number.
Number of customer's bank account.
IBAN number of customer's bank account.
Name of customer's bank.
BIC/SWIFT identifier of customer's bank account.
Person's birthday (yyyy-mm-dd)
area of business.
For businesses only.
Customer type ID, for businesses only.
National ID
Color that the customer entry is marked with. Possible values: "", "yellow", "red", "blue", "green".
Customer’s country.
Customer’s credit limit: the maximum amount of money (in account default currency) that they are allowed to owe.
Flag indicating that Erply does not keep track of the customer's balance (amount prepaid or due)
Customer manager (must be an employee)
COMPANY or PERSON. For businesses, the following ributes are set: fullName, businessName (both have the same value). For individuals, the following attributes are set: fullName, firstName, lastName. fullName is a combination of latter two: "lastName, firstName". fullName can be used for displaying customer's name wherever needed. Companies should have one name field and the attribute that is edited should be businessName. Persons should have separate fields for given name and surname (respective attributes: firstName, lastName).
Default payment deadline (in days).
A field that propagates from customer records to sales documents and lets the company categorize shipments by delivery method or delivery time.
Name with customer type
Whether the customer is marked with a do not sell flag or not.
In UI, the field is titled “E-invoice email address”.
Customer reference for e-invoices.
whether the customer wants to receive invoices via electronic channels.
E-invoice integration parameter.
EDI type. Possible values: 2DOC, 4DOC, SPECIAL.
Flag indicating that this customer does not want to receive email correspondence.
Used to indicate that this individual is a contact person / an employee in a particular business.
Factoring contract number.
First name / given name. For individuals only.
Full name of the customer, use for displaying customer name.
Gender. Erply API only accepts "male" "female" or an empty string.
Additional, custom home store ID
Location where the customer shops most frequently. https://learn-api.erply.com/requests/getwarehouses
Corresponding customer identifier in a system integrated with Erply (e.g. accounting software)
Whether the customer wants to receive invoices via Docura channels.
whether the customer wants to receive invoices via email.
Mark if a customer should be starred
Individual's job title Ids.
Last name / family name. For individuals only.
Assign the code of customer's loyalty/membership card. This code must match the sequence produced by card swipe.
For businesses only.
E-invoice integration parameter.
whether the customer wants the e-invoice operator to deliver paper mails (if such option is supported).
“Payer of invoices” (another customer).
Flag indicating that this customer pays via factoring (all invoices must be addressed to a designated third party)
Late fee / penalty for overdue invoices. The semantic meaning of this value is not strictly defined; usually we expect it to be “% per day”
Peppol ID
Flag indicating that coupons must not be automatically printed to this customer.
Assign the customer a price list
ID of the primary store
Customer’s reference number for sales invoices. Assign a reference number - if system is configured to use hand-created customer reference numbers. By default,not necessary, since reference numbers are created automatically.
Flag indicating that the customer will not earn points for purchases. (They can still spend existing points though.)
Flag “Sales for cash only”. By default,false
ID of the secondary store
A flag indicating that this customer wants to get goods with Waybills, not Invoice-Waybills.
Location where the customer signed up. https://learn-api.erply.com/requests/getwarehouses
Flag indicating that this customer must not be charged sales tax.
Feature used by Greek customers: office where the customer / supplier reports to. (This value must be shown on some printouts.)
A title (Mr / Mrs / Miss) etc.
Customer type. Possible values are "DOMESTIC", "EU", "OUTSIDE_EU", "EU_WITH_VAT
Customer's VAT number.
This is for web shop integrations: to store customers' web-shop login credentials in Erply.
Example response
[
{
"GLN": "901234500004",
"gender": "male"
}
]Changes
No recorded changes to this operation across all 1 revision of this API.