Integrações

Processo de integração do sistema

Banco do Brasil

Pix

Recebimentos de pix

{"pix":[{"endToEndId":"E18236120202310241126s0094c62752","txid":"1110323296010000001895700011417535","valor":"4.60","componentesValor":{"original":{"valor":"4.60"}},"chave":"485e87ab-9f2c-4f18-83c9-10dbbaf35173","horario":"2023-10-24T08:26:39.00-03:00","infoPagador":"Servico Funerario de Botucatu","pagador":{"cpf":"00000000000","nome":"NOME DO PAGADOR"}}]}

Fluxo

• Pix é pago pelo usuário
• BB envia webhook
• AWS - API gateway recebe o webhook (bbwh.doth.link)
• SQS (filaBBPix)
• Lambda (bb_MySql)

txid

GG.FFF.YYZZZ.TT.IIIIIIIIIII.RRRRRRRRRRR

• GG - grupo econômico
• FFF - 101 - unidade
• YYZZZZ - 23065 - (ano/dia)
• TT - 03 - tipo
• IIIIIIIIIII - 00000000001 - id do pix
• RRRRRRRRRRR - 00000000023 - id da referencia do pix

Tipos de Pix

• 01 – caixa mensalidade única
• 02 – caixa mensalidades múltiplas
• 03 – caixa ordem de serviço
• 04 – caixa parcela única (fazer)
• 05 – caixa contrato (fazer)
• 06 – avulsos – ok
• 07 – pré vendas – ok
• 08 – clinica
• 09 – exames

ClickSign

Processo de integração para assinatura de documentos

1. Criar conta na clicksign
2. Plano de intração
3. Gerar novo Token
4. Cadastrar webhook
   1. No webhook copiar a chave Hash

Webhook

Retorno de eventos pré definidos

WhatsApp

Url base: https:/doth/apis/clicksign/whatsapp.php?g=xx

acceptance_term_completed acceptance_term_refused acceptance_term_canceled acceptance_term_expired acceptance_term_error attempts_by_whatsapp_exceeded acceptance_term_sent

Enotas

Processo de integração utilizado para emissão de nota fiscal (serviços e produtos)

• A empresa deve possuir certificado digital
• Para cadastro de emissão de NFC-e deve possuir o códico CSC (cadastrado no Sefaz)

WebHook

Recebido após a emissão da nota fiscal (serviço ou produto)

Headers

• x-token - chave de validação (fixa)

tipo - NFS-e / NFC-e

nfeIdExterno

H.GG.FFF.T.IIIIIIIIIII.X.RRRRRRRRRRR

• H - Servidor (Homologação/Produção)
• GG - Grupo econôminco (000)
• FFF - Unidade (000)
• T - Tipo de nota: Plano, Os, Serviço, Venda, E cafe)
• IIIIIIIIIII - Id do tipo (00000000000)
• X - Separador (X)
• RRRRRRRRRRR - Id de referência (00000000000)

Tipos

• P - Plano
• O - Ordem de serviço
• S - Serviços
• V - Vendas
• C - Café

Tabelas

• P - Plano - insert tabela enotas_plns
• O - Ordem de serviço - insert tabela enotas_os
• S - Serviços - update tabela ordemservico_nfs
• V - Vendas - update tabela ordemservico_nfs
• C - Café - sem definição

NFS-e

{

   "tipo": "NFS-e",
   "empresaId": "string",
   "nfeId": "string",
   "nfeIdExterno": "string",
   "nfeStatus": "string",
   "nfeMotivoStatus": "string",
   "nfeLinkPdf": "http://api.enotasgw.com.br/file/(...)/pdf",
   "nfeLinkXml": "http://api.enotasgw.com.br/file/(...)/xml",
   "nfeNumero": "string",
   "nfeCodigoVerificacao": "string",
   "nfeNumeroRps": "string",
   "nfeSerieRps": "string",
   "nfeDataCompetencia": "date"

}

NFC-e

{

   "tipo": "NFC-e",
   "empresaId": "string",
   "nfeId": "001",
   "nfeStatus": "Autorizada",
   "nfeMotivoStatus": null,
   "nfeLinkDanfe": "http://api.enotasgw.com.br/file/(...)/pdf",
   "nfeLinkXml": "http://api.enotasgw.com.br/file/(...)/pdf",
   "nfeLinkConsultaPorChaveAcesso": "http://sistemas.sefaz.am.gov.br/nfceweb/formConsulta.do",
   "nfeNumero": "123",
   "nfeSerie": "1",
   "nfeChaveAcesso": "73349650010000005351606919674115087649800517",
   "nfeDataEmissao": "2017-01-02T17:20:32Z",
   "nfeDataAutorizacao": "2017-01-02T17:21:07Z",
   "nfeNumeroProtocolo": "353150000119390",
   "nfeDigestValue": "ssiUjiiOQkD2UGw"

}

MTLS

Bucket S3

versionamento: ativado colocar o arquivo

TrustStore

• Nome: truststore.pem
• Arquvivo a ser disponiblizado no S3
• Precisa estar versionado

Conteúdo

Chave enviada pelo banco, unificada em um único arquivo

• chave 1 - chave raiz (autoridade certificadora)
• chave 2 - chave intermediaria (serasa)
• chave 3 - chave privada (api.webhook...)

Vindi

Empresa especializada na cobrança de valores recorrentes via cartão de crédito

O Doth possui integração com o software Vindi. Isso significa que quando a fatura for paga na vindi, será enviado a informação de baixa para o sistema

Configuração

1. No código externo do cliente deve estar informado o número da inscrição
2. Criar webhook com status de fatura paga para o endereço: https://erp.doth.com.br/apis/vindi/hook.php?secret=x

Funcionamento

1. A cada fatura paga será enviada a informação da baixa diretamente para o sistema
2. É realizada uma pré-baixa que fica disponível em: Processos > Externos > Importar Vindi/pago. 5.07.04. - Imporar vindi/pago
3. É possível consultar as faturas em Aberto (ainda não processadas) ou Baixadas (já processadas)
4. Processar as baixas

Obs: é considerado como mês de pagamento o mês onde a fatura foi efetivamente lançada no cartão do cliente.

WhatsApp

Integração utilizada para envio de mensagens pelo sistema via whatsapp

A integração não serve para envio em massa

• Cadastrar instância no servidor
• Conectar whatsapp