v10

latestOpenAPI 3.1.1raw.githubusercontent.com2026-06-261653109.3 KB

Clientes

Atualizar cliente

Atualiza os dados de um cliente existente. Apenas os campos enviados serao atualizados.

patch/v1/customers/{id}

Path parameters

idstring uuid required

Example:550e8400-e29b-41d4-a716-446655440000

ID do cliente

Request body

namestring nullable

Nome do cliente

emailstring nullable

E-mail do cliente

documentstring nullable

CPF ou CNPJ

documentType'CPF' | 'CNPJ' nullable

Tipo do documento

phonestring nullable

Telefone com codigo do pais. Aceita com ou sem '+' no envio e e salvo apenas com digitos.

status'Active' | 'Inactive' nullable

Status do cliente

metadatastring nullable

Metadados em JSON

Example request

{
  "name": "Joao Silva Santos",
  "email": "joao.santos@email.com",
  "document": "12345678900",
  "documentType": "CPF",
  "phone": "5511999997777",
  "status": "Active"
}

Response

Cliente atualizado

messagestring nullable

Example response

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "externalId": "cliente_123",
    "name": "Joao Silva",
    "email": "joao@email.com",
    "document": "123.456.789-00",
    "documentType": "CPF",
    "phone": "5511999998888",
    "status": "Active",
    "address": {
      "street": "Rua das Flores",
      "number": "123",
      "complement": "Apto 45",
      "neighborhood": "Centro",
      "city": "Sao Paulo",
      "state": "SP",
      "postalCode": "01234-567",
      "country": "BR"
    },
    "createdAt": "2025-01-15T15:00:00Z"
  },
  "error": {
    "message": "Token invalido ou expirado.",
    "code": "unauthorized"
  }
}