Business Customers

Update a business customer

input only the fields you need to update.

patch/v1/customers/businesses/{id}

Request

Path parameters

idinteger required

customer Id

Query parameters

preserveOldCardNumberboolean

if the flag is present, then the previous card number value gets saved as an old card number

Request body

GLNstring

Global Location Number.

bankAccountNumberstring

Number of customer's bank account.

bankIbanstring

IBAN number of customer's bank account.

bankNamestring

Name of customer's bank.

bankSwiftCodestring

BIC/SWIFT identifier of customer's bank account.

businessAreaIdinteger

area of business.

codestring

Registry code

colorstring

Color that the customer entry is marked with. Possible values: "", "yellow", "red", "blue", "green".

countryIdinteger

Customer’s country.

creditLimitinteger

Customer’s credit limit: the maximum amount of money (in account default currency) that they are allowed to owe.

customerBalanceDisabledboolean

Flag indicating that Erply does not keep track of the customer's balance (amount prepaid or due)

customerGroupIdinteger
customerManagerIdinteger

Customer manager (must be an employee

defaultPaymentDeadLineinteger

Default payment deadline (in days).

deliveryTypeIdinteger

A field that propagates from customer records to sales documents and lets the company categorize shipments by delivery method or delivery time.

doNotSellboolean

Whether the customer is marked with a do not sell flag or not.

eInvoiceEmailstring

In UI, the field is titled “E-invoice email address”.

eInvoiceReferencestring

Customer reference for e-invoices.

eInvoicesViaEmailEnabledboolean

0 or 1: whether the customer wants to receive invoices via electronic channels.

ediCodestring

E-invoice integration parameter.

ediTypestring

EDI type. Possible values: 2DOC, 4DOC, SPECIAL.

emailOptOutboolean

Flag indicating that this customer does not want to receive email correspondence.

employeeIdinteger

Employee ID of the employee changing this company customer.

facebookNamestring
factoringContractNumberstring

Factoring contract number.

faxstring
genderstring

Gender. Erply API only accepts "male" "female" or an empty string.

homeStoreCustomIdinteger

Additional, custom home store ID

homeStoreIdinteger

Location where the customer shops most frequently. https://learn-api.erply.com/requests/getwarehouses

integrationCodestring

Corresponding customer identifier in a system integrated with Erply (e.g. accounting software)

invoicesViaDocuraEnabledboolean

0 or 1: whether the customer wants to receive invoices via docura.

invoicesViaEmailEnabledboolean

0 or 1: whether the customer wants to receive invoices via email.

isStarredboolean

Mark if a customer should be starred

loyaltyCardNumberstring

Assign the code of customer's loyalty/membership card. This code must match the sequence produced by card swipe.

mailstring
mobilestring
namestring

Name.

notesstring
operatorIdstring

E-invoice integration parameter.

paperMailsEnabledboolean

0 or 1: whether the customer wants the e-invoice operator to deliver paper mails (if such option is supported).

partialTaxExemptionboolean
payerIdinteger

“Payer of invoices” (another customer).

paysViaFactoringboolean

Flag indicating that this customer pays via factoring (all invoices must be addressed to a designated third party)

penaltyForOverduenumber

Late fee / penalty for overdue invoices. The semantic meaning of this value is not strictly defined; usually we expect it to be “% per day”

peppolIdstring

Peppol ID

phonestring
posCouponsDisabledboolean

Flag indicating that coupons must not be automatically printed to this customer.

pricelistIdinteger

Assign the customer a price list

pricelistId2integer
pricelistId3integer
pricelistId4integer
pricelistId5integer
primaryStoreIdinteger

ID of the primary store

referenceNumberstring

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.

rewardPointsDisabledboolean

Flag indicating that the customer will not earn points for purchases. (They can still spend existing points though.)

salesForCashOnlyboolean

Flag “Sales for cash only”. By default, false

secondaryStoreIdinteger

ID of the secondary store

shipGoodsWithWaybillsboolean

A flag indicating that this customer wants to get goods with Waybills, not Invoice-Waybills.

signUpStoreIdinteger

Location where the customer signed up. https://learn-api.erply.com/requests/getwarehouses

skypestring
taxExemptboolean

Flag indicating that this customer must not be charged sales tax.

taxofficeIdinteger

Feature used by Greek customers: office where the customer / supplier reports to. (This value must be shown on some printouts.)

twitterIdstring
typestring

Customer type. Possible values are "DOMESTIC", "EU", "OUTSIDE_EU".

typeIdinteger
vatNumberstring

Customer's VAT number.

webShopPasswordstring
webShopUsernamestring

This is for web shop integrations: to store customers' web-shop login credentials in Erply.

websitestring

Response

OK

idinteger

Example response

{
  "id": 73
}

Changes

No recorded changes to this operation across all 1 revision of this API.