curl --request PUT \
--url https://api.orbita.melonn.com/seller-suppliers/{id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"notifications_email": "purchasing@example.com"
}
'{
"id": 123,
"name": "Main Supplier Co.",
"id_type": "NIT",
"id_number": "900123456",
"active": true,
"phone_number": "+573001112233",
"notifications_email": "purchasing@example.com",
"external_id": "SUP-001",
"warehouse_configurations": [
{
"id": 11,
"seller_id": 456,
"seller_supplier_id": 123,
"warehouse_id": 5,
"unpacking_type": "IMMEDIATE",
"validation_type": "STRICT",
"experience_type": "GUIDED",
"creation_date": "2025-01-10T08:00:00.000Z",
"last_update_date": "2025-01-15T10:30:00.000Z",
"last_update_user_email": "integrations@example.com"
}
]
}{
"statusCode": 400,
"errorCode": "BAD_REQUEST",
"message": "body must NOT have fewer than 1 properties"
}{
"statusCode": 403,
"errorCode": "UNPACKING_CONFIGURATION_NOT_ALLOWED",
"message": "This seller cannot send warehouse_configurations"
}{
"statusCode": 404,
"errorCode": "SELLER_SUPPLIER_NOT_FOUND",
"message": "Seller supplier SUP-999 does not exist for this seller"
}{
"statusCode": 409,
"errorCode": "SELLER_SUPPLIER_ALREADY_EXISTS",
"message": "A supplier with external_id SUP-002 already exists for this seller",
"errorDetails": {
"seller_supplier_id": 124
}
}{
"statusCode": 422,
"errorCode": "INVALID_UNPACKING_CONFIGURATION",
"message": "Warehouse 5 is repeated in the request"
}Update seller supplier
Updates one of your suppliers.
How it works
Send only what changes: supplier fields, warehouse_configurations, or both. Fields you
don’t send keep their current value. The body cannot be empty. Properties not declared in
this schema are ignored (silently dropped), not rejected.
Each warehouse configuration you send is written in full: an omitted unpacking_type is
reset to DEFERRED and an omitted validation_type to FREE, rather than kept. Always
send both. Warehouses you don’t send keep their configuration.
The response includes only the configurations of the warehouses sent in the request; if you sent none, it includes all of the supplier’s configurations.
id_type, external_id and warehouse_configurations follow the same rules as
Create seller supplier, including the negotiated agreement required to send
warehouse_configurations.
curl --request PUT \
--url https://api.orbita.melonn.com/seller-suppliers/{id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"notifications_email": "purchasing@example.com"
}
'{
"id": 123,
"name": "Main Supplier Co.",
"id_type": "NIT",
"id_number": "900123456",
"active": true,
"phone_number": "+573001112233",
"notifications_email": "purchasing@example.com",
"external_id": "SUP-001",
"warehouse_configurations": [
{
"id": 11,
"seller_id": 456,
"seller_supplier_id": 123,
"warehouse_id": 5,
"unpacking_type": "IMMEDIATE",
"validation_type": "STRICT",
"experience_type": "GUIDED",
"creation_date": "2025-01-10T08:00:00.000Z",
"last_update_date": "2025-01-15T10:30:00.000Z",
"last_update_user_email": "integrations@example.com"
}
]
}{
"statusCode": 400,
"errorCode": "BAD_REQUEST",
"message": "body must NOT have fewer than 1 properties"
}{
"statusCode": 403,
"errorCode": "UNPACKING_CONFIGURATION_NOT_ALLOWED",
"message": "This seller cannot send warehouse_configurations"
}{
"statusCode": 404,
"errorCode": "SELLER_SUPPLIER_NOT_FOUND",
"message": "Seller supplier SUP-999 does not exist for this seller"
}{
"statusCode": 409,
"errorCode": "SELLER_SUPPLIER_ALREADY_EXISTS",
"message": "A supplier with external_id SUP-002 already exists for this seller",
"errorDetails": {
"seller_supplier_id": 124
}
}{
"statusCode": 422,
"errorCode": "INVALID_UNPACKING_CONFIGURATION",
"message": "Warehouse 5 is repeated in the request"
}Authorizations
Path Parameters
Your supplier external_id, or the Melonn supplier id. The value is matched against
external_id first; if none of your suppliers has that external_id and the value is
a positive integer, it is matched against the Melonn id.
1Body
Send only what changes. At least one property is required.
Supplier name. Cannot be blank.
\SWhether the supplier is active.
Identification type. Must be valid in a country where your account is active.
CC, NIT, OTHER, INE, CURP, RFC Identification number. Cannot be blank.
\SEmail for supplier notifications. Must be a valid email.
Supplier phone number. Cannot be blank.
\SYour own identifier for the supplier. Unique per seller. Cannot be blank.
\SConfigurations to write. Each one replaces the configuration of its warehouse in full (omitted values are reset to their defaults). Requires a negotiated agreement with Melonn.
Show child attributes
Show child attributes
Response
Supplier updated. Returns the supplier with its warehouse_configurations.
A supplier of your account.
Melonn id of the supplier.
Supplier name.
Identification type.
Identification number.
Whether the supplier is active. Supplier orders can only be created for active suppliers.
Supplier phone number.
Email for supplier notifications.
Your own identifier for the supplier, or null.
Show child attributes
Show child attributes