Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Exemplo de requisições GET, POST e PUT com payload e resposta esperadas em JSON para integração. Recomendamos autenticação com token no header da requisição

Índice
minLevel1
maxLevel7
outlinetrue

Estado
titleAPP
Estado
colourYellow
titleTOTEM
Estado
colourGreen
titleBoleto
Pegar infos de clientes (GET):

Request utilizada para pegar as informações do cliente no ERP com base no CPF/CNPJ dele

Expandir
titlePayload
Bloco de código
languagejson
{
  "cnpj_cpf": ""  # Documento do cliente (cpf/cnpj)
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "idnome_clientecompleto": "",            # Nome "nome": "",
    "fantasia": "",completo do cliente / razão social da empresa
    "tipo_pessoaaniversario": "",     "cnpj_cpf": "",       "ie_identidade": "", # Data de  "rg_orgao_emissor": "",aniversário do cliente
    "inscricaodata_municipalregistro": "",     "contribuinte_icms": "N",       "nacionalidade": "",
    "cidade_naturalidade": "",# Data de cadastro do cliente no ERP
    "estado_nascimentoativo": "",     "data_nascimento": "",     "estado_civil": "",
    "ativo": "",         # Cliente está ativo no ERP
    "Sexoid_remoto": "",              "profissao": "",
    "data_cadastro": "",  # ID do cliente dentro do ERP
    "cepid_contrato": "",      "endereco": "",     "numero": "", # ID do contrato "complemento": "",do cliente
    "bairrorua_endereco": "",     "cidade": "",        "uf": "",
    "latitude": "",# Nome da rua do endereço do cliente
    "longitudenumero_endereco": "",     "fone": "",     "telefone_comercial": "",
    "telefone_celular": "",# Número da casa do endereço do cliente
    "whatsappcep_endereco": "",      "email": "",     "obs": "",
    "alerta": ""
}

Pegar boletos abertos/faturas (GET):

Request utilizada para listar os boletos dos clientes com base id do cliente

Expandir
titlePayload
Bloco de código
languagejson
{ # Cep do endereço do cliente
    "idcidade_clienteendereco": ""
}
Expandir
titleResponse
Bloco de código
languagejson
{,      [    # Cidade do endereço  {
    do cliente
     "idcomplemento_faturaendereco": "",     # Complemento do endereço do cliente
    "nomebairro_clienteendereco": "",          # Bairro  "valor_inicial": "",  
    do endereço do cliente
     "valorestado_atualendereco": "",           #  "data_emissao": "",  
          "data_vencimento": "",Estado do endereço do cliente
}

Estado
titleAPP
Estado
colourYellow
titleTOTEM
Estado
colourGreen
titleBoleto
Pegar boletos abertos/faturas (GET):

Request utilizada para listar os boletos dos clientes com base no documento do cliente (cpf/cnpj)

Expandir
titlePayload
Bloco de código
languagejson
{
    "document": ""      # Documento do cliente (cpf/cnpj)
    "linhaid_digitavelcontrato": "",  # ID do contrato do cliente
}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
 "url_boleto": ""      {
  }     ] }

Pegar notas fiscais (GET):

Request utilizada para listar as notas fiscais emitidas para um cliente

Expandir
titlePayload
Bloco de código
languagejson
{     "id_clientefatura": ""
}
Expandir
titleResponse
Bloco de código
languagejson
{,      [  # ID utilizado para identificação e baixa {de Fatura 
          "idcode_notafatura": "",      # Valor composto pelo ID da fatura e docuemento "status": "",do cliente  
            "valornome_cliente": "",     # Nome do Cliente
          "valordocument_pagonumber": "",  # Documento do cliente, o mesmo informado para obter as faturas
  "data_lancamento        "remote_id": "",        # Código do cliente no ERP
          "datavalor_vencimentoinicial": "",    # Valor original do Boleto
          "datavalor_baixaatual": "",      # Valor atualizado na data da Consulta
        "url_nota_fiscal  "juros": "",           } # Juros aplicado ao ]
}

Pegar extratos financeiros (GET):

Request utilizada para listar os extratos financeiros de um cliente

Expandir
titlePayload
Bloco de código
languagejson
{boleto na data de consulta
          "id_clientemulta": ""
}
Expandir
titleResponse
Bloco de código
languagejson
{,      [      # Multa  {
 aplicado ao boleto na data de consulta
          "id_extrato_financeirodesconto": "",         # Desconto aplicado ao boleto na "data_lancamento": "",
  de consulta
          "data_vencimentoemissao": "",     # Data de emissão do Boleto
          "data_baixavencimento": "",  # Data de vencimento do Boleto
          "id_boletohistorico": "",        # Mensagem de referência  "id_nota": "",
 da Fatura (ex. Mensalidade Plano X)
          "valorbank_code": "",        # Codigo que indica  "valor_pago": "",
 a qual banco pertence a fatura
          "multalinha_digitavel": "",  # Linha digitavel do Boleto
          "jurosintegration_id": "",   # Id da integraçõ ERP a qual o boleto pertence
          "descontoidentifier": "",       # Identificador de pagamento (Ex. Carteira de cobrança)
          "obspix_code": "",         }# Código PIX copia e ]cola }

Pegar declaraçao de quitação de débitos (GET):

Request utilizada para listar as declarações de quitação de débito de um cliente

Expandir
titlePayload
Bloco de código
languagejson
{de sistema de pagamento do ERP
          "contract_id_cliente": "" }
Expandir
titleResponse
Bloco de código
languagejson
{     [ # Id do contrado(s) a qual pertence a {
Fatura
           "idbill_quitacaoreceipt": "",     # Cabeço de impressão gerado para o Totem (TEF)
      "ano    "bill_pix_receipt": "", # Cabeço de impressão gerado para o        "valor": "",Totem (PIX)
              "url_arquivo": ""
        }
    ]
}

Estado
titleAPP
Estado
colourYellow
titleTOTEM
Estado
colourGreen
title

...

Boleto
Pegar Contratos do Cliente (GET):

Request utilizado para listar todos os produtos/instalações/serviços de um clienteo contratos do cliente. Utilizado para listar os boletos por contrato. Para pleno funcionamento, ID do contrato deverá ser enviado junto ao response que lista fatura abertas.

Expandir
titlePayload
Bloco de código
languagejson
{
    "id_clientedocument": ""  # Documento do cliente (cpf/cnpj)
}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
"remote_id": "",      # Id {do Contrato no ERP. Utilizado para filtrar o boletos
    "idcontract_instalacaoname": "",   # Endereço da          "cepinstalação
}

Estado
titleAPP
Pegar notas fiscais (GET):

Request utilizada para listar as notas fiscais emitidas para um cliente

Expandir
titlePayload
Bloco de código
languagejson
{
    "document": "",    # Documento do cliente (cpf/cnpj)
    "enderecoid_cliente": "",  # ID do cliente no ERP
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "numero": "",[
        {
    "complemento": "",        "id_nota": "",      "bairro": "",       # ID da nota fiscal dentro "cidade": "",do ERP
            "uf"id_tipo_nota: "",          # ID do tipo da nota fiscal dentro "latitude": "",do ERP
            "longitudenumero_nota": "",          # Número da "obs": "",nota fiscal
            "servicosvalor": ["",                # {Valor da nota fiscal
                 "id_servico": "protocolo": "",            # Protocolo da nota fiscal
    "nome": "",       "data_lancamento": "",      # Data que a nota foi lançada "descricao": "",
     no ERP  
            "valoridentificacao": "",        # Identificação da nota fiscal
            "statusurl_nota_fiscal": "",      # Url do pdf da nota fiscal 
       "obs": "" }
         ]
}

Estado
titleAPP
Pegar extratos financeiros (GET):

Request utilizada para listar os extratos financeiros de um cliente

Expandir
titlePayload
Bloco de código
languagejson
{
    "document": ""    # Documento }do cliente (cpf/cnpj)
    "id_cliente": ""  # ID do ]cliente no ERP
}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
}     ] }

Pegar todos os produtos (GET):

Request utilizada para listar todos os produtos disponíveis no sistema. Isso é utilizado para mapear o produto do eCommerce, assim o prospecto/lead já é criado com um vínculo aos produtos

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{     [
        {
            "id_serviconota": "",             "nome": "",    # ID da fatura
            "descricaodata_lancamento": "",          # Data de lançamento da fatura
   "valor         "data_vencimento": "",          # Data de vencimento da fatura
            "obsdata_baixa": "",               }
 # Data da baixa da fatura
  ] }

Pegar todos os revendedores (GET):

Request utilizada para listar todos os revendedores, Isso é utilizado para mapear os revendedores no eCommerce, assim as vendas dos mesmos podem ser vinculados a eles nos relatórios e os prospectos/leads já são criados com o vínculo do revendedor que realizou a venda/captação

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{     [    "historico": "",    {             "id_revendedor": "",# Histórico da fatura
            "nomevalor": "",             "obs": ""      # Valor recebido }da fatura
   ] }

Pegar todos os funcionários (GET):

Request utilizada para listar todos os funcionários, Isso é utilizado para direcionar os atendimentos gerados pelo eCommerce/App caso eles sejam vinculados com um funcionário

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{     [   "saldo": "",     {               #  "id_funcionario": "",Valor da fatura
            "nomecobranca": "",               "obs": ""  # Descrição da cobrança
        }
    ]
}

...

Estado
titleAPP
Pegar declaração de quitação de débitos (GET):

Request utilizada para listar todos os departamentos, Isso é utilizado para direcionar os atendimentos gerados pelo eCommerce/App caso eles sejam vinculados com um departamentoas declarações de quitação de débito de um cliente

Response
Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
title

    "document": ""    # Documento do cliente (cpf/cnpj)
    "id_cliente": ""  # ID do cliente no ERP
}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_departamentoquitacao": "",    # ID da quitação de débito
            "nomeano": "",            # Ano referente "obs": ""
 a quitação de débito
      }     ]
}

Pegar todos os vencimentos (GET):

Request utilizada para listar os vencimentos, isso é utilizado para que os prospectos sejam criados com o vencimento vinculado corretamente

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{ "valor": "",       [   # Valor total da quitação de {débito
            "idurl_vencimentoarquivo": "",     # URL do pdf da quitação de débito
 "data": "",
            "obs": ""         }
    ]
}

Estado
titleAPP
Pegar

...

instalações/produtos de um cliente (GET):

Request utilizada para listar as origens comerciáis, isso é utilizado para que os prospectos sejam criados com a origem comercial vinculada corretamente. (Ex. Google, Outdoor, Indicação de Amigo, Anúncio de Rádio)todos os produtos/instalações/serviços de um cliente

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
title

    "document": ""    # Documento do cliente (cpf/cnpj)
    "id_cliente": ""  # ID do cliente no ERP
}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_origemservico": "",           # ID do serviço no ERP
            "nome": "",             "obs": ""    # Nome do serviço
   }     ] }

Pegar todas as cidades (GET):

Request utilizada para listar as cidades cadastradas no sistema, isso é utilizado pois muitos sistemas utilizam um código proprietário para a cidade. assim os prospectos são criados com a cidade vinculada corretamente.

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{   "situacao": "", [         {   # Situação do serviço no ERP (ativo, suspenso, etc.)
            "id_cidadeobs": "",                  # Observações/comentários sobre o serviço
            "nomevalor": "",                # Valor "latitude": "",do serviço
            "longitudenumero_plano": "",         # Número/posição do serviço no "obs": ""ERP
         }   "endereco": "", ] }

Pegar todos os tipos de atendimentos (GET):

Request utilizada para listar todos os tipos de atendimentos, Isso é utilizado para que os atendimentos criados pelo eCommerce/App sejam do tipo correto utilizado

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{     [      # Endereço referente {ao serviço do cliente
         "id_tipo_de_atendimento": "",}
              "nome": "",
            "obs": ""
        }
    ]
}

...

]
}

Estado
colourPurple
titlePROSPECTO
Estado
colourRed
titleLEAD
Estado
colourYellow
titleTOTEM
Pegar todos os produtos (GET):

Request utilizada para listar os status de prospectos, isso é utilizado para classificar os prospectos conformes eles são criados e para atualizar os prospectos durante a automação. (Ex. Inicial, Em analise, Reprovado, Suspenso, Aprovado, Cancelado)todos os produtos disponíveis no sistema. Isso é utilizado para mapear o produto do eCommerce, assim o prospecto/lead já é criado com um vínculo aos produtos

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "statusid_prospeccaoservico": "",   # ID do produto/serviço no ERP
            "nome": "",         # Nome de apresentação "obs": ""do produto
        }     ]
}

Criar prospectos (POST):

Request utilizada para a criação de uma prospecção no sistema, esse é o principal canal de entrada de novas assinaturas

Expandir
titlePayload
Bloco de código
languagejson
{
    "nome": "","descricao": "",    # Descrição do produto
      "nome_fantasia": "",     "status_prospeccaovalor": "status_prospeccao",       "tipo_pessoa": "",
    "cnpj_cpf": "", # Valor do produto
      "ie_identidade": "",     "data_nascimentoobs": "",     "data_cadastro": "",     "id_revendedor": "id_revendedor",
    "id_origem": "id_origem",# Observações
       "id_vencimento": "id_vencimento", }
    "cep": "",
    "endereco": "",
    "numero": "",
    "bairro": "",
    "cidade]
}

Estado
colourPurple
titlePROSPECTO
Estado
colourRed
titleLEAD
Estado
colourYellow
titleTOTEM
Pegar todos os revendedores (GET):

Request utilizada para listar todos os revendedores, Isso é utilizado para mapear os revendedores no eCommerce, assim as vendas dos mesmos podem ser vinculados a eles nos relatórios e os prospectos/leads já são criados com o vínculo do revendedor que realizou a venda/captação

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_revendedor": "",  # ID do revendedor no ERP
            "nome": "",           # Nome do revendedor
            "documento": "",      # Documento do revendedor (CPF/CNPJ)
            "email": "",          # Email do revendedor
            "obs": ""             # Observações
        }
    ]
}

Estado
titleAPP
Estado
colourPurple
titlePROSPECTO
Estado
colourYellow
titleTOTEM
Pegar todos os funcionários (GET):

Request utilizada para listar todos os funcionários, Isso é utilizado para direcionar os atendimentos gerados pelo eCommerce/App caso eles sejam vinculados com um funcionário

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_funcionario": "",   # ID do funcionário no ERP
            "nome": "",             # Nome do funcionário
            "obs": ""               # Observações
        }
    ]
}

Estado
titleAPP
Pegar todos os departamentos (GET):

Request utilizada para listar todos os departamentos, Isso é utilizado para direcionar os atendimentos gerados pelo eCommerce/App caso eles sejam vinculados com um departamento

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_departamento": "",    # ID do departamento no ERP
            "nome": "",               # Nome do departamento
            "obs": ""                 # Observações
        }
    ]
}

Estado
colourPurple
titlePROSPECTO
Estado
colourYellow
titleTOTEM
Pegar todos os vencimentos (GET):

Request utilizada para listar os vencimentos, isso é utilizado para que os prospectos sejam criados com o vencimento vinculado corretamente

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_vencimento": "",    # ID do vencimento no ERP
            "data": "",             # "Nome" da data de vencimento (Exemplo: "dia 5")
            "obs": ""               # Observações
        }
    ]
}

Estado
colourPurple
titlePROSPECTO
Estado
colourRed
titleLEAD
Estado
colourYellow
titleTOTEM
Pegar as origens comerciais (GET):

Request utilizada para listar as origens comerciais, isso é utilizado para que os prospectos sejam criados com a origem comercial vinculada corretamente. (Ex. Google, Outdoor, Indicação de Amigo, Anúncio de Rádio)

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_origem": "",    # ID da origem comercial no ERP
            "nome": "",         # Nome da origem comercial
            "obs": ""           # Observações
        }
    ]
}

Estado
colourPurple
titlePROSPECTO
Estado
colourRed
titleLEAD
Estado
colourYellow
titleTOTEM
Pegar todas as cidades (GET):

Request utilizada para listar as cidades cadastradas no sistema, isso é utilizado pois muitos sistemas utilizam um código proprietário para a cidade. assim os prospectos são criados com a cidade vinculada corretamente.

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_cidade": "",    # ID da cidade no ERP
            "nome": "",         # Nome da cidade no ERP
            "latitude": "",     # Latitude da cidade
            "longitude": "",    # Longitude da cidade
            "obs": ""           # Observações
        }
    ]
}

Estado
titleAPP
Pegar todos os tipos de atendimentos (GET):

Request utilizada para listar todos os tipos de atendimentos, Isso é utilizado para que os atendimentos criados pelo eCommerce/App caiam no sistema com o tipo correto

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_tipo_de_atendimento": "",   # ID do tipo de atendimento no ERP
            "nome": "",                     # Nome do tipo de atendimento no ERP
            "obs": ""                       # Observações
        }
    ]
}

Estado
colourPurple
titlePROSPECTO
Estado
colourYellow
titleTOTEM
Pegar todos os status de prospectos (GET):

Request utilizada para listar os status de prospectos, isso é utilizado para classificar os prospectos conformes eles são criados e para atualizar os prospectos durante a automação. (Ex. Inicial, Em analise, Reprovado, Suspenso, Aprovado, Cancelado)

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "status_prospeccao": "",    # Código do status no ERP
            "nome": "",                 # Nome do status no ERP
            "obs": ""                   # Observações
        }
    ]
}

Estado
colourPurple
titlePROSPECTO
Estado
colourYellow
titleTOTEM
Criar prospectos (POST):

Request utilizada para a criação de uma prospecção no sistema, esse é o principal canal de entrada de novas assinaturas.

Se for necessário o EPR deve informar todos APIs necessárias para criar um pedido no sistema integrado com o maior numero das informações possível.

Se for o caso pode-se fracionar o em varias APIs para chegar ao resultado final, exemplo: API para cadastro de Prospecto/Cliente, API para cadastro de endereço, APi para upload de arquivos no prospecto, etc.

Expandir
titlePayload
Bloco de código
languagejson
{
    "nome": "",                     # Nome do Cliente ou Responsavel pela Empresa
    "razão_social": "",             # Razão do social para clientes PJ (Opcional)
    "tipo_pessoa": "",              # Tipo da pessoa, Física ou Juridica
    "cnpj_cpf": "",                 # CPF ou CNPJ do cliente
    "ie_identidade": "",            # Inscrição Estadual parra clientes PJ (Opcional)
    "data_nascimento": "",          # Data de nascimento do cliente ou do responsável
    "id_revendedor": "",            # Id do revendedor
    "id_origem": "",                # Id da Origem comercial
    "id_vencimento": "",            # Id do Vencimento no ERP
    "cep": "",                      # CEP do cliente
    "endereco_instalação": "",      # Logradouro do endereço de instalação
    "numero_instalação": "",        # Numero do endereço de instalação
    "bairro_instalação": "",        # Bairro do endereço de instalação
    "cidade_instalação": "",        # Cidade do endereço de instalação
    "complemento_instalação": "",   # Complemento do endereço de instalação
    "referencia_instalação": "",    # Referencia do endereço de instalação
    "uf_instalação": "",            # Estado do endereço de instalação
    "endereco_cobranca": "",        # Logradouro do endereço de cobrança
    "numero_cobranca": "",          # Numero do endereço de cobrança
    "bairro_cobranca": "",          # Bairro do endereço de cobrança
    "cidade_cobranca": "",          # Cidade do endereço de cobrança
    "complemento_cobranca": "",     # Complemento do endereço de cobrança
    "referencia_cobranca": "",      # Referencia do endereço de cobrança
    "uf_cobranca": "",              # Estado do endereço de cobrança
    "latitude": "",                 # Latitude da instalação
    "longitude": "",                # Longitude da instalação
    "telefone": "",                 # Telefone residencial
    "celular": "",                  # Celular
    "celular_extra": "",            # Celular extra (geralmente whatsapp)
    "email": "",                    # Email
    "obs": "",                      # Resumo de todas as informações do pedido
    "servicos": [                   # Array serviços contratados/interesse
        {
            "id_servico"            # ID do serviço no ERP
        }
    ],         
    "anexos": [                     # Array de anexos dos documentos anexados ao pedido
        {
            "nome_documento": "",   # Nome do documento
            "formato": "",          # Formato do arquivo
            "base_64" ""    	    # Conteúdo do arquivo em base 64
        }
    ]
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "id_prospecto": "",      # Id do Prospecto retornado do ERP
    "obs": ""                # Observação ou menssagem do ERP
}

Estado
colourRed
titleLEAD
Estado
colourYellow
titleTOTEM
Criar lead (POST):

Request utilizada para a criação de um lead no sistema, esse é como você irá registrar clientes que tem a intenção de assinar no futuro ou que ainda não estão cobertos pelos seus serviços/produtos.

Dados podem varia conforme formulário do pre-checkout

Expandir
titlePayload
Bloco de código
languagejson
{
    "nome": "",           # Nome do cliente
    "documento": "",      # Documento do cliente
    "email": "",          # Email do cliente
    "telefone": "",       # Telefone do cliente
    "endereco": "",       # Logradouro do endereço de instalação
    "numero": "",         # Numero do endereço de instalação
    "bairro": "",         # Bairro do endereço de instalação
    "cidade": "",         # Cidade do endereço de instalação
    "estado": "",         # Estado do endereço de instalação
    "CEP": "",            # CEP do endereço de instalação
    "cobertura": "",      # JSON com dados da Cobertura
    "latitude": "",       # Latitude da instalação
    "longitude": "",      # Longitude da instalação
    "revendedor": "",     # Nome do revendedor
    "id_revendedor": "",  # ID do revendedor no ERP
    "extra_data": ""      # Dados extras do lead
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "id_lead": "",  # ID do lead retornado do ERP
    "obs": ""       # Observação ou menssagem do ERP
}

Estado
titleAPP
Criar atendimento (POST):

Request utilizada para criar um atendimento/chamado/ajuda com a possibilidade de enviar um anexo em formato Base64

Expandir
titlePayload
Bloco de código
languagejson
{
    "id_cliente": "",                 # ID do cliente no ERP
    "id_servico": "",                 # ID do serviço do cliente no ERP
    "id_tipo_de_atendimento": "",     # ID do tipo de atendimento escolhido pelo cliente no ERP
    "id_departamento": "",            # ID do departamento escolhido pelo cliente no ERP
    "id_funcionario": "",             # ID do funcionário responsável no ERP
    "email": "",                      # Email do cliente
    "telefone": "",                   # Telefone do cliente
    "assunto": "",                    # Assunto do chamado que o cliente esta abrindo
    "mensagem": "",                   # Mensagem do chamado que o cliente esta abrindo
    "anexo": [                        # Anexos enviados pelo cliente (se a opção estiver liberada)
        {
            "anexo": "",              # Conteúdo do arquivo em base 64
            "obs": "",                # Observação do anexo
            "nome_anexo": ""          # Nome do anexo
        }
    ]
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "id_atendiemnto": "",   # ID do lead retornado do ERP
    "obs": ""               # Observação ou menssagem do ERP
}

Estado
titleAPP
Estado
colourYellow
titleTOTEM
Estado
colourGreen
titleBoleto
Habilitação provisória (POST):

Request utilizada para habilitar provisoriamente um serviço suspenso geralmente por falta de pagamento. também conhecido como ativação de confiança

Expandir
titlePayload
Bloco de código
languagejson
{
    "id_cliente": "",   # ID do cliente no ERP
    "id_servico": "",   #  "id_cidade": "id_cidade",
    "complemento": "",ID do serviço do cliente no ERP
}
Expandir
titleResponse
Bloco de código
languagejson
{
     "referenciastatus": "",   # Status "uf": "",
    "latitude": "",
    "longitude": "",do serviço após a chamada de ativação (se foi ativo ou não)
}

Estado
colourPurple
titleProspecto
Estado
colourYellow
titleTOTEM
Edição do prospecto (PUT):

Request utilizada para atualizar uma prospecção conforme a automação acontece. Nem todos os campos são necessariamente editados/atualizados

Expandir
titlePayload
Bloco de código
languagejson
{
    "foneid_prospecto": "",     "telefone_comercial": "",     "telefone_celular": "",
    "whatsapp": "",# ID do prospecto no ERP
     "ramalstatus_prospeccao": "",      "email": "",
    "obs": "",# ID do status do prospecto no ERP
    "alertaid_revendedor": "",     "servicos": [    # ID do revendedor do {ERP
      "obs": "",      "id_servico": ""         }    # ]Observações
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "id_prospectostatus": "",   # Status atual do prospecto "obs": ""no ERP
}

...

Estado
titleAPP
Edição do cliente (PUT):

Request utilizada para a criação de um lead no sistema, esse é como você irá registrar clientes que tem a intenção de assinar no futuro ou que ainda não estão cobertos pelos seus serviços/produtosatualizar as informações de um cliente. Geralmente atualiza-se apenas as informações de contato (email, telefone, WhatsApp)

Expandir
titlePayload
Bloco de código
languagejson
{
    "nome": "",
    "nome_fantasia": "",
    "tipo_pessoa": "",
    "cnpj_cpfid_cliente": "",
    "ie_identidade": "",     "data_nascimento": "",
    "data_cadastro": "",
    "id_revendedor": "id_revendedor",
    "cep": "",     # ID do cliente no ERP
    "endereconome": "",     "numero": "",     "bairro": "",     "cidade": "", # Nome do  "id_cidade": "id_cidade",cliente no ERP
    "complementofantasia": "",       "referencia": "",       "uf": "",
    "latitude": "", # Nome fantasia do cliente para empresa
    "longitudetipo_pessoa": "",     "fone": "",     "telefone_comercial": "",
    "telefone_celular": "", # Tipo da pessoa, Física ou Juridica
    "whatsappcnpj_cpf": "",     "ramal": "",        "email": "", # CPF ou CNPJ "obs": "",do cliente
    "alertaie_identidade": "",     "servicos": [    # Inscrição Estadual parra  {
       clientes PJ (Opcional)
    "idrg_orgao_servicoemissor": "",       # 
   } "inscricao_municipal": "",   ]
}
Expandir
titleResponse
Bloco de código
languagejson
{ # 
    "idcontribuinte_leadicms": "",
    "obs": ""
}

Criar atendimento (POST):

Request utilizada para criar um atendimento/chamado/ajuda com a possibilidade de enviar um anexo em formato Base64

Expandir
titlePayload
Bloco de código
languagejson
{ # 
    "id_clientenacionalidade": "id_cliente",          # 
    "idcidade_serviconaturalidade": "id_servico",    # 
    "id_tipo_de_atendimentoestado_nascimento": "id_tipo_de_atendimento",      # 
    "iddata_departamentonascimento": "id_departamento",        "id_funcionario# 
    "estado_civil": "id_funcionario",     "email": "",      # 
    "telefoneativo": "",      "assunto": "",     "mensagem": "",     "obs": "",# 
    "alertaSexo": "",     "anexo": [         {       # 
    "anexoprofissao": B64_DO_ARQUIVO,"",              # 
    "obsdata_cadastro": "",          # 
    "nome_anexocep": "",         }
    ]
}
Expandir
titleResponse
Bloco de código
languagejson
{       "id_atendiemnto": "",     "obs": ""
}

Habilitação provisória (POST):

Request utilizada para habilitar provisoriamente um serviço suspenso geralmente por falta de pagamento. também conhecido como ativação de confiança

Expandir
titlePayload
Bloco de código
languagejson
{ # 
    "id_clienteendereco": "id_cliente",     "id_servico": "id_servico",
}
Expandir
titleResponse
Bloco de código
languagejson
{          # 
    "statusnumero": "",
}

Edição do prospecto (PUT):

Request utilizada para atualizar uma prospecção conforme a automação acontece. Nem todos os campos são necessariamente editados/atualizados

Expandir
titlePayload
Bloco de código
languagejson
{                 # 
    "id_prospectocomplemento": "",     "status_prospeccao": "status_prospeccao",       "id_revendedor": "id_revendedor",# 
    "obsbairro": "",        "alerta": "", }
Expandir
titleResponse
Bloco de código
languagejson
{     "status": "",
}

Edição do cliente (PUT):

Request utilizada para atualizar as informações de um cliente. Geralmente atualiza-se apenas as informações de contato (email, telefone, WhatsApp)

Expandir
titlePayload
Bloco de código
languagejson
{ # 
    "id_clientecidade": "",                 # 
    "nomeuf": "",                     # 
    "fantasialatitude": "",               # 
    "tipo_pessoalongitude": "",       "cnpj_cpf": "",       "ie_identidade": "",# 
    "rg_orgao_emissorfone": "",       "inscricao_municipal": "",     "contribuinte_icms": "N",     "nacionalidade": "",# 
    "cidadetelefone_naturalidadecomercial": "",     "estado_nascimento": "",# 
    "datatelefone_nascimentocelular": "",       "estado_civil": "",# 
    "ativowhatsapp": "",     "Sexo": "",          "profissao": "",# 
    "data_cadastro"email": "",      "cep": "",     "endereco": "",     "numero": "",# 
    "complementoobs": "",        "bairro": "",     "cidade": "",     "uf": "",# 
    "latitudealerta": "",      "longitude": "",     "fone": "",     "telefone_comercial": "",# 
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "telefone_celularstatus": "", "",
}

Estado
colourPurple
titleProspecto
Estado
colourYellow
titleTOTEM
Envio de arquivos (POST)

Request utilizada para enviar arquivos anexados pelos clientes na hora da assinatura, de modo a deixar os arquivos vinculados aos prospectos/leads. Os arquivos são enviados em Base64, geralmente imagens (jpg, png, gif) ou PDF

Expandir
titlePayload
Bloco de código
languagejson
{
    "whatsappid_prospecto": "",
    "emailnome_arquivo": "",
    "obsarquivo": "",
    "alertaobs": "",
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "status": "",
}

...

Estado
titleAPP
Estado
colourYellow
titleTOTEM
Estado
colourGreen
titleBoleto
Baixa na fatura/Sinalização de pagamento (POST)

Request utilizada para enviar arquivos anexados pelos clientes na hora da assinatura, de modo a deixar os arquivos vinculados aos prospectos/leads. Os arquivos são enviados em Base64, geralmente imagens (jpg, png, gif) ou PDFsinalizar ao ERP que a fatura em questão do cliente foi paga pelo terminal de atendimento da Datacake (Totem) ou pelo aplicativo; permitindo o ERP marcar a mesma como paga e caso necessário retomar os serviços suspensos

Expandir
titlePayload
Bloco de código
languagejson
{
    "id_prospectocliente": "id_cliente",
    "nomeid_arquivofatura": "",
    "arquivo": ""
    "obs": "id_fatura",
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "status": "",
}

Baixa na fatura/Sinalização de pagamento (POST)

...

Estado
colourPurple
titleProspecto
Estado
colourYellow
titleTOTEM
Status do Prospecto (GET):

Request utilizada para receber o status atual do prospecto, mantendo o sistema da Datacake sincronizado com o ERP

Expandir
titlePayload
Bloco de código
languagejson
{
    "id_clienteprospecto": "id_clienteprospecto",
    "id_fatura":
"id_fatura",
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "status": "",
    "motivo": "motivo_do_cancelamento_ou_rejeição"
}