Atualizar Parceiro

Use esta rota para atualizar os dados de um parceiro previamente cadastrado.

PUTv3/sub_sellers/:sub_seller_id

Request Variable Path

Atributo	Tipo	Descrição
sub_seller_id	string	ID do parceiro.

cuidado

É necessário salvar o sub_seller_id que a Marlim retorna nas solicitações de criação na sua aplicação. Somente com este id será possível para prosseguir com a atualização.

Request Body Params

Atenção

Todos os campos do tipo string devem ser informados com caracteres alfanuméricos sem acentuação ou caracteres especiais.

Atributo	Tipo	Descrição
email	string	E-mail da empresa.
automatic_anticipation_enabled	boolean	Indica se o recebedor receberá antecipações automaticamente.
annual_revenue	int32	Receita anual estimada da empresa
website	string	Website da empresa.
phone_number	object	Objeto Telefone da empresa.
phone_number[country_code]	string	Código do país do telefone da empresa (DDI), Ex: +55.
phone_number[ddd]	string	DDD do telefone da empresa.
phone_number[number]	string	Número do telefone da empresa.
main_address	object	Objeto Endereço principal da empresa.
main_address[country]	string	País do endereço da empresa, no formato sigla do país. Só serão aceitos o formato ISO 3166-1 alfa-2 (duas-letras) Ex: BR, US, UY... Máximo em caracteres: 2
main_address[zip_code]	string	CEP do endereço da empresa.
main_address[state]	string	Estado do endereço da empresa.
main_address[city]	string	Cidade do endereço da empresa.
main_address[neighborhood]	string	Bairro do endereço da empresa.
main_address[street]	string	Rua do endereço da empresa.
main_address[number]	string	Número do endereço da empresa.
main_address[complementary]	string	Complemento do endereço da empresa.
status	string	Status do parceiro. Valores aceitos: active e inactive.

cuidado

Restrições: caso o status atual do parceiro seja pending, refused ou blocked, não é permitido realizar a atualização. A mudança só poderá ocorrer quando o status for diferente desses.

Response Object

Atributo	Tipo	Descrição
status	string	Status do parceiro. Valor padrão: pending.
sub_seller_id	string	ID do parceiro.
name	string	Nome do parceiro.
date_created	dateTime	Data de criação do parceiro no formato ISODateTime.
date_updated	dateTime	Data de atualização do parceiro no formato ISODateTime.
business_name	string	Razão Social do parceiro.
social_name	string	Nome Fantasia do parceiro.
email	string	E-mail do parceiro.
document	string	CNPJ do parceiro.

Exemplo de Response

{
  "status": "active",
  "sub_seller_id": "sub_k4m6Rw5rlQszEY7fiuRe",
  "name": "Empresa Jedi",
  "date_created": "2025-07-07T19:26:42.779Z",
  "date_updated": "2025-07-07T20:26:42.779Z",
  "business_name": "Empresa Jedi LTDA",
  "social_name": "Empresa Jedi",
  "email": "contato@empresajedi.com.br",
  "document": "12345678000190"
}

Exemplos

Parceiro Atualizado com Sucesso

Request

curl -X PUT "https://api.marlim.co/v3/sub_sellers/sub_k4m6Rw5rlQszEY7fiuRe" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d '{
  "email": "novo@empresajedi.com.br",
  "automatic_anticipation_enabled": true,
  "annual_revenue": 1000000000,
  "website": "https://empresajedi.com.br",
  "phone_number": {
    "country_code": "+55",
    "ddd": "11",
    "number": "988888888"
  },
  "main_address": {
    "country": "BR",
    "zip_code": "01234567",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Centro",
    "street": "Rua Jedi",
    "number": "123",
    "complementary": "Sala 45"
  },
  "status": "active"
}'

Response200

{
  "status": "active",
  "sub_seller_id": "sub_k4m6Rw5rlQszEY7fiuRe",
  "name": "Empresa Jedi",
  "date_created": "2025-07-07T19:26:42.779Z",
  "date_updated": "2025-07-07T20:26:42.779Z",
  "business_name": "Empresa Jedi LTDA",
  "social_name": "Empresa Jedi",
  "email": "contato@empresajedi.com.br",
  "document": "12345678000190"
}

Parceiro não encontrado

Request

curl -X PUT "https://api.marlim.co/v3/sub_sellers/sub_123456789" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d '{
  "status": "active"
}'

Response404

{
  "errors": {
    "type": "Sub Seller with id [ sub_123456789 ] was not found."
  }
}

Status inválido

Request

curl -X PUT "https://api.marlim.co/v3/sub_sellers/sub_k4m6Rw5rlQszEY7fiuRe" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d '{
  "status": "invalid_status"
}'

Response400

{
  "errors": {
    "type": "validation",
    "message": "The status provided is invalid. Allowed values are: [ active ], and [ inactive ]."
  }
}