# Criar Vendedor

Para iniciar o processo de integração, siga os passos abaixo para cadastrar um novo vendedor com sucesso.

{% hint style="warning" %}
Importante

Após criar um novo vendedor, salve o **X-Token-Api** retornado na resposta: ele é a credencial que autentica e autoriza todas as transações dessa conta.
{% endhint %}

## Criar seller

> Cria um novo seller no sistema com novos campos obrigatórios

```json
{"openapi":"3.0.0","info":{"title":"API de Sellers v2 - Atualizada","version":"2.1.0"},"servers":[{"url":"https://api.barte.com","description":"Servidor de produção"},{"url":"https://sandbox-api.barte.com","description":"Servidor de sandbox"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Token-Api"}},"schemas":{"SellerCreateRequest":{"type":"object","required":["document","companyName","fantasyName","sellerUrl","webhook","email","password","owner","address","contact","account"],"properties":{"document":{"type":"string","description":"CPF ou CNPJ do seller"},"companyName":{"type":"string","description":"Nome da empresa"},"fantasyName":{"type":"string","description":"Nome fantasia da empresa"},"sellerUrl":{"type":"string","format":"uri","description":"URL do site do seller"},"ip":{"type":"string","format":"ipv4","description":"Endereço IP do vendedor"},"webhook":{"type":"string","format":"uri","description":"URL do webhook para notificações"},"email":{"type":"string","format":"email","description":"Email de contato"},"password":{"type":"string","description":"Senha para acesso"},"mccCpf":{"type":"string","enum":["VETERINARY_SERVICES","SPECIAL_TRADE_CONTRACTORS","TAXI_CABS_AND_LIMOUSINES","MISCELLANEOUS_GENERAL_MERCHANDISE","MISCELLANEOUS_FOOD_SHOPS","TAILORS_SEAMSTRESSES_MENDING","MISCELLANEOUS_APPAREL_SHOPS","DOOR_TO_DOOR_SALES","ARTIST_SUPPLY_CRAFT_SHOPS","BEAUTY_AND_BARBER_SHOPS","MISCELLANEOUS_PERSONAL_SERVICES","TOWING_SERVICES","COMPUTER_MAINTENANCE_REPAIR","BUSINESS_SERVICES","AUTOMOTIVE_SERVICE_SHOPS","DOCTORS_AND_PHYSICIANS","DENTISTS_AND_ORTHODONTISTS","MEDICAL_SERVICES_HEALTH_PRACTITIONERS","LEGAL_SERVICES_ATTORNEYS","PROFESSIONAL_SERVICES"],"description":"Código MCC obrigatório quando document for CPF"},"owner":{"$ref":"#/components/schemas/OwnerRequest"},"address":{"$ref":"#/components/schemas/AddressRequest"},"contact":{"$ref":"#/components/schemas/ContactRequest"},"account":{"$ref":"#/components/schemas/AccountRequest"}}},"OwnerRequest":{"type":"object","required":["name","document","birthdate"],"properties":{"name":{"type":"string","maxLength":100,"description":"Nome completo do proprietário"},"document":{"type":"string","pattern":"^[0-9]{11}$","description":"CPF do proprietário (11 dígitos)"},"birthdate":{"type":"string","format":"date","description":"Data de nascimento no formato YYYY-MM-DD"}}},"AddressRequest":{"type":"object","required":["country","state","city","district","street","zipCode","number"],"properties":{"country":{"type":"string","description":"Sigla do país"},"state":{"type":"string","description":"Sigla do estado"},"city":{"type":"string","description":"Nome da cidade"},"district":{"type":"string","description":"Bairro"},"street":{"type":"string","description":"Rua"},"zipCode":{"type":"string","description":"CEP (apenas números)"},"number":{"type":"string","description":"Número"},"complement":{"type":"string","description":"Complemento"}}},"ContactRequest":{"type":"object","required":["name","email","countryCode","phone"],"properties":{"name":{"type":"string","description":"Nome do responsável"},"email":{"type":"string","format":"email","description":"Email do responsável"},"countryCode":{"type":"string","description":"Código do país"},"phone":{"type":"string","description":"Telefone com DDD"}}},"AccountRequest":{"type":"object","required":["account","transferType","pix"],"properties":{"account":{"type":"object","required":["bank","issuer","issuerDigit","number","bankDigit","accountType"],"properties":{"bank":{"type":"string","description":"Código do banco"},"issuer":{"type":"string","description":"Agência bancária"},"issuerDigit":{"type":"string","description":"Dígito da agência"},"number":{"type":"string","description":"Número da conta"},"bankDigit":{"type":"string","description":"Dígito da conta"},"accountType":{"type":"string","enum":["CHECKING_ACCOUNT","SAVINGS_ACCOUNT"],"description":"Tipo da conta"}}},"transferType":{"type":"string","enum":["PIX","BANK_ACCOUNT"],"description":"Tipo de transferência (NOVO CAMPO OBRIGATÓRIO)"},"pix":{"type":"object","required":["keyType","key"],"properties":{"keyType":{"type":"string","enum":["CPF","CNPJ","EMAIL","PHONE","DOCUMENT","ALLEATORY_KEY"],"description":"Tipo da chave PIX"},"key":{"type":"string","description":"Chave PIX"}}}}},"SellerCreateCompleteResponse":{"type":"object","properties":{"document":{"type":"string"},"idSeller":{"type":"integer"},"companyName":{"type":"string"},"email":{"type":"string","format":"email"},"webhook":{"type":"string","format":"uri","description":"URL do webhook (DEPRECIADO - use webhooks array)"},"webhooks":{"type":"array","description":"Array de webhooks do seller","items":{"$ref":"#/components/schemas/Webhook"}}}},"Webhook":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid","description":"Identificador único do webhook"},"title":{"type":"string","description":"Nome do webhook"},"domains":{"type":"array","description":"Eventos vinculados (ORDER, SUBSCRIPTION)","items":{"type":"string","enum":["ORDER","SUBSCRIPTION"]}},"active":{"type":"boolean","description":"Indica se o webhook está ativo"},"url":{"type":"string","format":"uri","description":"URL configurada para recebimento"}}},"SellerCreatePartialResponse":{"type":"object","properties":{"document":{"type":"string"},"idSeller":{"type":"integer"},"companyName":{"type":"string"},"email":{"type":"string","format":"email"},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"}}}}}},"ValidationError":{"type":"object","properties":{"errors":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"}}}}},"AuthenticationError":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"}}}}}},"ForbiddenError":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"}}}}}},"InternalError":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"}}}}}}}},"paths":{"/v2/seller":{"post":{"summary":"Criar seller","description":"Cria um novo seller no sistema com novos campos obrigatórios","tags":["Sellers"],"parameters":[{"name":"X-Token-Api","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"Token de autenticação UUID v4"},{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string","enum":["application/json"]},"description":"Tipo de conteúdo da requisição"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellerCreateRequest"}}}},"responses":{"200":{"description":"Seller criado com sucesso","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/SellerCreateCompleteResponse"},{"$ref":"#/components/schemas/SellerCreatePartialResponse"}]}}}},"400":{"description":"Erro de validação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"401":{"description":"Token inativo ou inexistente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Acesso negado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"500":{"description":"Erro interno do servidor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}}}}}}}
```