Atualizar Parceiro

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

PUT/v1/sellers/:seller_id

Request Variable Path

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

caution

É necessário salvar o 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

Atributo	Tipo	Descrição
email	string	E-mail da empresa.
phone_number	object	Objeto Telefone da empresa.
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[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.

Response Object

Atributo	Tipo	Descrição
status	string	Status do parceiro.
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.
phone_number	object	Objeto Telefone do parceiro.
main_address	object	Objeto Endereço principal do parceiro.
managing_partner	object	Objeto Sócio administrador do parceiro.
bank_account	object	Objeto Conta bancária do parceiro.

Exemplos

Parceiro Atualizado com Sucesso

Request

curl -X PUT "https://api.isaac.marlim.co/v1/sellers/se_k4m6Rw5rlQszEY7fiuRe" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d '{
  "email": "novo@escolajedi.com.br",
  "phone_number": {
    "ddd": "11",
    "number": "988888888"
  },
  "main_address": {
    "zip_code": "01234567",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Centro",
    "street": "Rua Jedi",
    "number": "123",
    "complementary": "Sala 45"
  }
}'

Response200

{
  "status": "active",
  "seller_id": "se_k4m6Rw5rlQszEY7fiuRe",
  "name": "Escola Jedi",
  "date_created": "2025-03-30T20:20:12.480Z",
  "date_updated": "2025-03-30T20:20:12.480Z",
  "business_name": "Escola Jedi LTDA",
  "social_name": "Escola Jedi",
  "email": "novo@escolajedi.com.br",
  "document": "12345678000190",
  "phone_number": {
    "ddd": "11",
    "number": "988888888"
  },
  "main_address": {
    "zip_code": "01234567",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Centro",
    "street": "Rua Jedi",
    "number": "123",
    "complementary": "Sala 45"
  },
  "managing_partner": {
    "name": "Luke Skywalker",
    "document": "12345678900",
    "birthdate": "01/01/1980",
    "phone_number": {
      "ddd": "11",
      "number": "988888888"
    },
    "address": {
      "zip_code": "01234567",
      "state": "SP",
      "city": "São Paulo",
      "neighborhood": "Centro",
      "street": "Rua Jedi",
      "number": "123",
      "complementary": "Apto 45"
    }
  },
  "bank_account": {
    "bank": "001",
    "agency": "1234",
    "agency_digit": "5",
    "account_number": "123456",
    "account_digit": "7",
    "type": "checking"
  }
}

Parceiro não encontrado

Request

curl -X PUT "https://api.isaac.marlim.co/v1/sellers/se_123456789" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d '{
  "status": "active"
}'

Response404

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

Status inválido

Request

curl -X PUT "https://api.isaac.marlim.co/v1/sellers/se_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 ]."
  }
}