⚙ Funcionalidades:
Criação de pedidos | |
Criação de pedidos para clientes existentes | |
Criação de lead | |
Listagem de boletos | |
Listagem de boletos para totem | |
PDF de boleto | |
Baixa de boleto | |
Informações do cliente | |
Criação de chamado | |
Listagem de nota fiscal | |
PDF da nota fiscal | |
Listar planos do cliente | |
Listar planos bloqueados do cliente | |
Desbloqueio de confiança | |
Listar faturas do cliente | |
Editar dados do cliente | |
...
Expandir |
---|
|
order = Pedido feito pelo cliente message = mensagem com inforrmações do pedido, geralmente usado num campo de observações |
Expandir |
---|
|
Bloco de código |
---|
| {
"remote_id" = ""
"remote_message" = ""
"is_issue" = False
} | remote_id = ID do pedido dentro do ERP remote_message = Resposta da API ou None is_issue = Pedido foi aberto como chamado ou não |
Este método é chamado quando um pedido é criado dentro do sistema e o cliente não é usuário do erp, ou ele é cliente do erp e a configuração Procedimento para Pedidos Migração esta em Criar Pedido/Prospecto
Criação de pedido para cliente já existente:
Expandir |
---|
|
order = Pedido feito pelo cliente message = Mensagem com informações do pedido, geralmente usado num campo de observações customer_document_number = CPF/CNPJ do cliente wda_user = Usuário do cliente |
Expandir |
---|
|
Bloco de código |
---|
| {
"remote_id" = ""
} | remote_id = ID do pedido no ERP |
Este método é chamado quando um pedido é criado dentro do sistema e o cliente já é usuário do erp, e a configuração Procedimento para Pedidos Migração esta em Criar Chamado/Atendimento
Criação de lead:
Expandir |
---|
|
lead = Informações do lead gerado |
Este método é chamado quando um lead é gerado durante o checkout para criar um lead dentro do ERP
Listar revendedores:
Expandir |
---|
|
Bloco de código |
---|
| [
{
"code" = ""
"name" = ""
"taxvat" = ""
"email" = ""
}
] | code = ID do revendedor no ERP name = Nome do revendedor taxvat = CPF/CNPJ do revendedor email = Email do revendedor |
Este método é chamado quando se abre a página para configurar um revendedor, ele é usado para associar um revendedor no sistema datacake com o ERP
Listar produtos:
Expandir |
---|
|
Bloco de código |
---|
| [
{
"codigo" = ""
"nome" = ""
}
] | codigo = ID do produto no ERP nome = Nome do produto |
Este método é chamado quando se abre a página para configurar um produto, ele é usado para associar um produto no sistema datacake com o ERP
Listar datas de vencimento:
Expandir |
---|
|
Bloco de código |
---|
| [
{
"code" = ""
"name" = ""
}
] | code = ID da data de vencimento no ERP name = Dia do vencimento |
Este método é chamado quando se abre a página para configurar um vencimento de fatura, ele é usado para associar uma data de vencimento no sistema datacake com o ERP
Listar origens comerciais:
Expandir |
---|
|
Bloco de código |
---|
| [
{
"code" = ""
"description" = ""
}
] | code = ID da origem comercial no ERP description = Nome da origem comercial |
Este método é chamado quando se abre a página para configurar uma origem comercial, ele é usado para associar uma origem comercial no sistema datacake com o ERP
...
Listar faturas:
Expandir |
---|
|
customer_document_number = CPF/CNPJ do cliente contract_id = ID do contrato (opcional) |
Expandir |
---|
|
Bloco de código |
---|
| [
{
"document_number" = ""
"fatura" = ""
"nome_cliente" = ""
"valor_inicial" = ""
"valor_final" = ""
"juros" = ""
"multa" = ""
"emissao" = ""
"vencimento" = ""
"historico" = ""
"link_boleto" = ""
"linha_digitavel" = ""
"code_fatura" = ""
"identifier" = ""
"remote_id" = ""
"pix_code" = ""
}
] | document_number = CPF/CNPJ do cliente fatura = ID da fatura nome_cliente = Nome do cliente valor_inicial = Valor inicial da fatura valor_final = Valor final da fatura juros = Juros da fatura multa = Multa da fatura emissao = Data de emissão do boleto vencimento = Data de vencimento historico = ID ou nome do plano link_boleto = url do boleto (usa a função “Pegar pdf de um boleto“ se estiver vazio) linha_digitavel = Código da linha digitável, usado para criar o código de barra no boleto do totem code_fatura = Código da fatura no ERP identifier = Identificador de qual método pix utilizar, caso haja vários configurados remote_id = ID do boleto no ERP pix_code = Código do pix pra ser usado nesse boleto, usa o configurado no sistema se estiver vazio |
Este método é chamado nas listagem de boleto, tanto do site, quanto do app e do totem, deve retornar as faturas do cliente no ERP
Pegar pdf de um boleto:
Expandir |
---|
|
boleto_id = ID do boleto no ERP |
Expandir |
---|
|
Bloco de código |
---|
| {
"base_64" = ""
} | base_64 = string contendo o pdf do boleto em formato de base64 |
Este método é chamado quando o cliente quer acessar o pdf de uma fatura e o campo link_boleto
da fatura veio vazio, tanto do site, quanto do app e do totem, o aplicativo pode exigir esse método por questões de segurança para não acessar um link fora do sistema.
Pegar uma fatura pelo ID:
...
Este método é usado na listagem de boletos do totemfaturas do totem e na baixa de fatura, funciona de forma similar ao Listar faturas, porém deve retornar apenas a fatura que o id é igual ao customer_bill_id
Baixa de boleto:
Expandir |
---|
|
Estado |
---|
colour | Purple |
---|
title | Transaction |
---|
| transaction = Transação do boleto que foi pago boleto_id = ID do boleto que foi pago customer_document_number = CPF/CNPJ do cliente |
Expandir |
---|
|
Bloco de código |
---|
| {
"success" = Booleano falando se a baixa foi um sucesso ou não
"api_response" = Resposta completa da api, independente se deu certo ou não
} | success = Booleano falando se a baixa foi um sucesso ou não api_response = Resposta completa da api, independente se deu certo ou não |
Este método é chamado quando uma fatura é paga pelo sistema (pix se ele foi integrado com o banco e TEF), usado para dar baixa em uma fatura dentro do erp
...
Pegar contatos do cliente (email, celular):
Expandir |
---|
|
customer_document_number = CPF/CNPJ do cliente |
Expandir |
---|
|
Bloco de código |
---|
| [
{
type = ""
value = ""
}
] | type = Tipo do contato, os valores podem ser "email" ou "phone" value = String contendo o contato do cliente |
Este método é chamado para compartilhar faturas, criar conta no app e alguns outros pontos que precisam do contato do cliente, ele deve retornar os contatos (email, celular) do cliente do ERP
...
Pegar texto para avaliar pendência interna:
Expandir |
---|
|
customer_document_number = CPF/CNPJ do cliente |
Expandir |
---|
|
Bloco de código |
---|
| [
“mensagem de pendencia interna“,
“outra mensagem de pendencia interna“
] | Lista de strings com cada mensagem de pendencia interna para ser avaliada |
Este método é chamado para fazer a validação de pendência interna do cliente dentro do ERP, ele deve retornar as mensagens que vão ser avalidadas para saber se aquele cliente já tem uma pendência com o provedor, caso o cliente não esteja no ERP ou não tenha pendencias com o provedor esse método deve retornar uma lista vazia