GoDeep - Documentação
HomeB2BB2CHUBAplicativoAPIs
HomeB2BB2CHUBAplicativoAPIs
  1. CLIENTES
  • GoDeep
    • Quem Somos
    • Meios de pagamento - B2C
  • ERPs
    • Integração Sankhya
    • ERPs integrados com a GoDeep
  • Documentação Funcional
    • Deep B2B
      • Fretes
      • Configurações gerais
      • Promoções
        • Cupons de Desconto
      • Pedidos
        • Cobrança de taxa em cima do valor do pedido
      • Meios de Pagamento
        • Itaú
    • Deep B2C
      • Produtos
        • Marcas
        • Seletor Mix
        • Importador manual de listas de preço
      • Pedidos
        • Pedidos - Status
        • Endpoint Compras por WhatsApp
      • Fretes
        • Fretes
        • Correios
        • Data Frete
        • Dedalog
        • Frenet
        • Melhor Envio
        • TransPaulo
        • Total Express
        • Intelipost
        • Jadlog
        • Jamef
      • Meios de Pagamento
        • Itaú
      • Promoções
        • Cupons de Desconto
      • Institucionais
        • Páginas institucionais
      • Configurações gerais
        • Importação manual de produtos
    • Deep HUB
      • Marketplaces
        • Marketplace F1
        • Amazon
        • Mercado Livre
      • Configurações gerais
        • Erro ao criar produto no Mercado Livre – B2C
    • Deep Sales
      • Aplicativo Deep Sales
  • APIs
    • Deep B2B
      • Produtos
        • Informações sobre o endpoint
        • cadastrar produtos e relacionamentos (completo)
        • cadastrar produto
        • cadastrar produto kit
        • cadastrar produto com garantia extendida
        • atualizar produto
        • atualizar estoque do produto
        • atualizar listas de preço do produto
        • listar produtos
        • listar identificadores dos produtos
        • obter produto
        • listagem simples (codigo produto e dados de estoque)
      • Produtos Relacionados
        • obter produtos relacionados
        • obter produtos similares
        • obter produtos complementares
        • cadastrar produtos similares
        • cadastrar produtos complementares
        • cadastrar produtos relacionados
      • PRODUTOS CONCEITOS
        • cadastrar conceito
        • atualizar conceito
        • listar conceitos
        • obter conceito
      • PRODUTOS PREÇO
        • Informações sobre o endpoint
        • cadastrar preco para um produto existente
        • atualizar preco de um produto existente
        • listar precos de um produto existente
        • obter o preco de um produto existente por segmentacao
        • atualizar precos por lista de preco
        • consultar processos de atualizacao de lista
      • PRODUTOS ESTOQUE
        • cadastrar estoque para um produto existente
        • atualizar estoque de um produto existente
        • deletar o estoque de um produto existente por segmentacao (Não Usar)
        • listar os estoques de um produto existente
        • obter o estoque de um produto existente por segmentacao
      • PRODUTOS ATRIBUTOS
        • cadastrar atributo
        • atualizar atributo
        • deletar atributo (Não Usar)
        • deletar atributo de uma classe existente (Não Usar)
        • listar atributos
        • obter atributo
      • PRODUTOS VALORES DE ATRIBUTOS
        • cadastrar valor de atributo para um produto existente
        • cadastrar multiplos atributos para um produto existente
        • cadastrar multiplos valores para um atributo especifico e um produto existente
        • atualizar valor de atributo de um produto existente
        • deletar o valor do atributo de um produto existente (Não Usar)
      • PRODUTOS CATEGORIA
        • cadastrar categoria
        • cadastrar vinculo cliente e categoria
        • atualizar categoria
        • deletar categoria (Não Usar)
        • listar categorias
        • obter categoria
      • PRODUTOS CLASSE
        • cadastrar classe
        • cadastrar classe com classe pai
        • cadastrar atributo para uma classe existente
        • cadastrar multiplos atributos para uma classe existente
        • atualizar classe
        • deletar classe (Não Usar)
        • listar classes
        • obter classe
      • PRODUTOS RESERVA DE ESTOQUE
        • consultar reservas de estoque
      • IMPOSTOS REGIME TRIBUTÁRIO
        • cadastrar regime tributario
        • atualizar regime tributario
        • deletar regime tributario (Não Usar)
        • listar regime tributario
        • obter regime tributario
      • IMPOSTOS MATRIZ TRIBUTÁRIA
        • Informações sobre o endpoint
        • cadastrar ou atualizar matriz tributaria
        • listar matriz tributaria
        • obter matriz tributaria
      • IMPOSTOS (IPI) MATRIZ TRIBUTÁRIA DE IPI
        • cadastrar matriz tributaria IPI
        • listar matriz tributaria IPI
        • obter matriz tributaria IPI
      • VENDEDORES / REPRESENTANTES
        • Informações sobre o endpoint
        • cadastar vendedores
        • atualizar vendedores
        • listar vendedores
        • obter vendedores
        • remover vendedor (Não Usar)
      • CARTEIRAS
        • Informações sobre o endpoint
        • cadastrar carteira
        • atualizar carteira
        • obter carteira
        • listar carteiras
        • remover carteira (Não Usar)
      • CLIENTES
        • Informações sobre o endpoint
          INFO
        • cadastrar cliente
          POST
        • atualizar cliente
          PUT
        • obter cliente
          GET
        • listar cliente
          GET
        • remover cliente (Não Usar)
          DELETE
      • CLIENTES SEGMENTOS
        • listar segmentos
        • obter segmento
        • cadastrar segmentos
        • atualizar segmentos
      • CLIENTES CONTATOS
        • listar crm contatos
        • cadastrar crm contatos
        • obter crm contatos
        • atualizar crm contatos
        • remover crm contato (Não Usar)
      • PEDIDOS
        • listar pedidos
        • obter pedido
        • atualizar pedido
        • atualizar pedido com cancelamento parcial de itens
      • PEDIDOS NOTAS
        • Informações sobre o endpoint de notas
        • cadastrar notas
        • listar notas
        • obter nota
        • atualizar nota
        • remover nota (Não Usar)
      • CHECAGEM DE EXISTÊNCIA
        • CRM
        • not existing data entities
      • ARQUIVOS
        • cadastrar arquivo
      • DESCONTO PROGRESSIVO
        • listar
        • obter
        • atualizar
        • cadastrar
        • remover (Não Usar)
      • RELATÓRIOS COMISSÕES
        • Informações sobre o endpoint de comissões
        • Listar Comissões
        • Cadastrar
      • CONDIÇÕES DE PAGAMENTO
        • Informações sobre o endpoint de condições de pagamento
        • listar
        • obter
        • cadastrar
        • atualizar
        • remover (Não Usar)
      • PEDIDOS EXTERNOS
        • cadastrar
        • atualizar
        • obter
      • CONSULTA PRODUTOS (LOJA)
        • Informações sobre o endpoint de consulta de produtos na loja
        • Consulta Produtos Geral
        • Consulta Produtos por Código
  1. CLIENTES

Informações sobre o endpoint

INFO
http://apidatain-prod.f1ws.com.br/
Este endpoint permite o gerenciamento dos clientes (consumidores) que serão cadastrados na loja

Dependências#

Segmentos (/crmsegment) - É possível vincular os clientes a segmentos, mas é necessário que o segmento tenha sido criado primeiro na API para que depois ele seja vinculado ao cliente

Campos#

CampoDescriçãoTipoObrigatório
f1_codeIdentificador único do cliente na loja.varcharSim
codeCódigo do cliente no ERP.varcharSim
person_typeTipo de pessoa, informar "J" para pessoa jurídica e "F" para pessoa físicavarcharSim
cgcCPF/CNPJ do cliente, somente números.varcharSim
name_fancyNome fantasia.varcharNão
name_corporateRazão Social.varcharNão
registration_stateInscrição estadual.varcharNão
registration_municipalInscrição municipal.varcharNão
phone_numberTelefone do cliente, informar apenas números.varcharSim
cell_phone_numberTelefone celular do cliente, informar apenas números.varcharNão
date_of_birthData de nascimentodateNão
email_invoiceE-mail do cliente, será o e-mail utilizado para que o cliente faça o login na loja. Deve ser enviado apenas um e-mail e não pode conter caracteres especiais no e-mail ou ao final do mesmovarcharSim
external_segment_codeCódigo externo do segmento (O campo deve ser preenchido com null caso não exista segmento no cliente).varcharSim
price_listCódigo da lista de preço do cliente.varcharNão
creditValor do crédito do cliente.decimalSim
allow_post_paymentIndica se permite pós pagamento. 0 para não permite e 1 para permiteboolSim
average_payment_periodPrazo médio de pagamento, em dias.intSim
tax_regimeCódigo do regime tributário do cliente.varcharNão
icms_taxpayerIndica se o cliente é contribuinte de ICMS.intNão
suframa_codeCódigo suframa.varcharNão
suframa_expiration_dateData de expiração do código suframa.dateNão
createdData da criação do cliente.dateNão
default_order_typeTipo de pedido padrão.varcharNão
default_operation_typeTipo de operação padrão, informar a string "REVE" fixamente.varcharSim
exclusive_payment_method_condition_installmentCódigo da condição de pagamento padrão.varcharNão
simples_codeCódigo do tipo de simples nacional do cliente na loja.varcharNão
minimum_order_valueValor minimo para os pedidos do cliente.decimalNão
maximum_order_valueValor máximo para os pedidos do cliente.decimalNão
moderatedIndica se o cliente está moderado. 1 para sim e 0 para nãoboolNão
integratedCampo onde é possível realizar o controle se o cliente foi integrado ao não. 1 para sim e 0 para nãoboolNão
integrated_messageCampo para informar possíveis problemas que o ERP não está permitindo que o cliente seja integradovarcharNão
billing_distribution_centerInformação do código de centro para faturamento dos pedidos do cliente, quando aplicávelvarcharNão
cnaeCNAE do cliente.varcharNão
secondary_cnaesCNAE secondarios para o cliente.varcharNão
block_card_paymentDefine se o cliente pode ou não realizar compras com cartão. (1 = Sim e 0 = Não)boolNão
responsible_crm_user_idID do usuário responsável pela criação do cliente.intNão
responsible_crm_user_typeTipo do usuário responsável pela criação do cliente.varcharNão
responsible_crm_user_nameNome do usuário responsável pela criação do cliente.varcharNão
responsible_crm_user_mailEmail do usuário responsável pela criação do cliente.varcharNão
responsible_crm_user_external_codeCódigo externo do responsável pela criação do cliente.varcharNão
responsible_crm_client_external_codeCódigo externo do cliente criado pelo responsável.varcharNão
address_ibge_codeCódigo do IBGE referente ao CEP do clientevarcharNão
address_streetRua.varcharSim
address_numberNúmero.varcharSim
address_complementComplemento.varcharNão
address_stateUF.varcharSim
address_cityCidade.varcharSim
address_neighborhoodBairro.varcharSim
address_countryPaís.varcharNão
address_referenceReferência.varcharNão
address_zipcodeCEP.varcharSim
delivery_address_ibge_codeCódigo do IBGE referente ao CEP do clientevarcharNão
delivery_address_streetRua do endereço de entrega.varcharSim
delivery_address_numberNúmero do endereço de entrega.varcharSim
delivery_address_complementComplemento do endereço de entrega.varcharNão
delivery_address_stateUF do endereço de entrega.varcharSim
delivery_address_cityCidade do endereço de entrega.varcharSim
delivery_address_neighborhoodBairro do endereço de entrega.varcharSim
delivery_address_countryPaís do endereço de entrega.varcharNão
delivery_address_referenceReferência do endereço de entrega.varcharNão
delivery_address_zipcodeCEP do endereço de entrega.varcharSim
charge_address_ibge_codeCódigo do IBGE referente ao CEP do clientevarcharNão
charge_address_streetRua do endereço de cobrança.varcharSim
charge_address_numberNúmero do endereço de cobrança.varcharSim
charge_address_complementComplemento do endereço de cobrança.varcharNão
charge_address_stateUF do endereço de cobrança.varcharSim
charge_address_cityCidade do endereço de cobrança.varcharSim
charge_address_neighborhoodBairro do endereço de cobrança.varcharSim
charge_address_countryPaís do endereço de cobrança.varcharNão
charge_address_referenceReferência do endereço de cobrança.varcharNão
charge_address_zipcodeCEP do endereço de cobrança.varcharSim
activeIndica se o cliente está ativo ou inativo. 1 para ativo e 0 para inativoboolSim
export_dateData da exportação do clientedateNão
modifiedCampo onde é possível indicar se houve modificações no cliente pelo ERPintNão
walletsConjunto de carteiras vinculadas ao cliente.conjuntoNão
customfieldsConjunto de campos customizaveis vinculados ao cliente.conjuntoNão
conceptsConjunto de conceitos vinculados ao cliente.conjuntoNão
distributioncentersConjunto de centros de distribuição que o cliente pode realizar compras.conjuntoNão

Informações do conjunto wallets#

CampoDescriçãoTipoObrigatório
codeCódigo externo da carteira que será vinculada ao cliente.varcharSim
sellersConjunto de vendedores a serem vinculados a carteira sendo informada.conjuntoNão

Informações do conjunto sellers#

CampoDescriçãoTipoObrigatório
codeCódigo externo do vendedor a ser vinculado a carteira.varcharSim

Informações do conjunto customfields#

CampoDescriçãoTipoObrigatório
identificationCódigo externo do campo customizável na loja.varcharSim
labelLabel do campo para exibição.varcharSim
valueValor do campo.varcharSim

Informações do conjunto concepts#

CampoDescriçãoTipoObrigatório
codeCódigo externo do conceito.varcharSim

Informações do conjunto distributioncenters#

CampoDescriçãoTipoObrigatório
codeCódigo externo do centro de distribuição.varcharSim
nameNome do centro de distribuição.varcharSim

Informações do conjunto productlines (Bandeiras)#

O node de productlines é um node opcional e serve para que no momento da requisição do vendedor, já possa ser feito o vinculo com as linhas de produtos (bandeiras) permitidas.
Importante: Essa funcionalidade só pode ser utilizada via ativação do modulo necessário
CampoDescriçãoTipoObrigatório
codeCódigo externo da linha de produto (Bandeira) permitida.varcharSim
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request INFO 'http://apidatain-prod.f1ws.com.br/'
Response Response Example
{}

Requisição

Nenhum

Respostas

🟢200Success
application/json
Body
object {0}
Modificado em 2025-06-23 20:17:41
Página anterior
remover carteira (Não Usar)
Próxima página
cadastrar cliente
Built with