Integração Analytics

h1. Envio de Duplicatas

*Índice*
# [[Envio de Duplicatas#Introdução|Introdução]]
# [[Envio de Duplicatas#Notificador - Dados da Duplicata|Notificador - Dados da Duplicata]]
# [[Envio de Duplicatas#Notificador - Duplicatas para Envio de Email|Notificador - Duplicatas para Envio de Email]]
# [[Envio de Duplicatas#Notificador - Consulta de Duplicatas|Notificador - Consulta de Duplicatas]]

h2. Introdução

O presente documento tem por objetivo orientar as empresas de ERP na geração dos arquivos e/ou tabelas necessárias para integração com o módulo de envio de duplicatas

Dúvidas ou maiores esclarecimentos podem ser obtidos pelo e-mail suporte@ibtech.inf.br ou pelo telefone (47) 3370-0504.

h2. Notificador - Dados da Duplicata

Consulta detalhes da duplicata.

*Importante!* Este SQL possui parâmetros.

Layout da tabela/visão:

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| titulo * | String | 255 | Identificação única para o título. Em caso de chave composta, sugerimos concatenar os campos usando algum separador |
| tituloFormatado | String | 255 | Identificação do título formatada de forma visual para o usuário |
| codCliente | String | 255 | Codigo do Cliente |
| documento | String | 255 | Número do Documento/Seu Número. |
| numeroBancario | String | 255 | Número bancário/Nosso Número. |
| codPortador | String | 255 | Código do Portador |
| dataEmissao | Date | | Data de emissão do título |
| dataVctoOriginal | Date | | Data de vencimento original do título |
| dataVencimento | Date | | Data de vencimento do título |
| valorTitulo | Double | | Valor do Título |
| tipoCobrança | String | 255 | Descrição do tipo de cobrança, caso não possuir, retornar NULL |
| codRepresentante | String | 255 | Código do representante |
| nomePortador | String | 255 | Nome do Portador |
| cnpjSacado | String | 15 | (opcional) cnpj do sacado, em caso de endosso, trazer o cnpj do endosso |
| codTipoTitulo | String | 255 | Código do Tipo de Título |
| nomeTipoTitulo | String | 255 | Nome do Tipo de Título |

Lista de Parâmetros:

|_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| :pCodEmpresa | String/Integer | 10 | (opcional) Código da empresa no ERP |
| :pTitulo | String | 255 | Código do cliente |

h2. Notificador - Duplicatas para Envio de Email

Listar títulos/duplicatas em aberto. Normalmente estes registros são provenientes do cadastro de contas a receber.

*Importante!* Este SQL possui parâmetros.

Layout da tabela/visão:

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| titulo * | String | 255 | Identificação única para o título. Em caso de chave composta, sugerimos concatenar os campos usando algum separador |
| tituloFormatado | String | 255 | Identificação do título formatada de forma visual para o usuário |
| dataVencimento | Date | | Data de vencimento do título |
| dataVctoOriginal | Date | | Data de vencimento original do título |
| codPortador | String | 255 | Código do Portador |
| nomePortador | String | 255 | Código do Portador |
| codCliente | String | 255 | Código do Cliente |
| codRepres | String | 255 | Código do Representante |
| valorTitulo | Double | | Valor do Título |
| codTipoTitulo | String | 255 | Código do Tipo de Título |
| nomeTipoTitulo | String | 255 | Nome do Tipo de Título |

Lista de Parâmetros:

|_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| :pCodEmpresa | String/Integer | 10 | (opcional) Código da empresa no ERP |
| :pDataInicio | String | 10 | Data inicial para filtrar o vencimento |
| :pDataFim | String | 10 | Data final para filtrar o vencimento |
| :pCodRepres | String | 255 | Código do Representante |
| :pCodCliente | String | 255 | Código do Cliente |

h2. Notificador - Consulta de Duplicatas

Listar títulos/duplicatas em aberto por cliente. Normalmente estes registros são provenientes do cadastro de contas a receber.

*O SQL deve listar somente títulos em aberto.*

*Importante!* Este SQL possui parâmetros.

Layout da tabela/visão:

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| titulo * | String | 255 | Identificação única para o título. Em caso de chave composta, sugerimos concatenar os campos usando algum separador |
| tituloFormatado | String | 255 | Identificação do título formatada de forma visual para o usuário |
| documento | String | 255 | Número do Documento/Seu Número |
| dataEmissao | Date | | Data de emissão do título |
| dataVencimento | Date | | Data de vencimento do título |
| valorTitulo | Double | | Valor do Título |
| codPortador | String | 255 | Código do Portador |
| nomePortador | String | 255 | Nome do Portador |
| tipoCobrança | String | 255 | Descrição do tipo de cobrança, caso não possuir, retornar NULL |
| codTipoTitulo | String | 255 | Código do Tipo de Título |
| nomeTipoTitulo | String | 255 | Nome do Tipo de Título |

Lista de Parâmetros:

|_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| :pCodEmpresa | String/Integer | 10 | (opcional) Código da empresa no ERP |
| :pCodCliente | String | 255 | Código do cliente |
| :pCodTitulo | String | 255 | Código do Título |
| :pCodRepresentante | String | 255 | Código do Representante |
| :pUsuarioInterno | Integer | | Usuário Interno Logado (0 - Não / 1 - Sim (Representante ou Cliente)) |

h2. Notificador - Consulta de Envio Manual

*Importante!* Este SQL possui parâmetros.

Layout da tabela/visão:

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| titulo * | String | 255 | Identificação única para o título. Em caso de chave composta, sugerimos concatenar os campos usando algum separador |
| tituloFormatado | String | 255 | Identificação do título formatada de forma visual para o usuário |
| documento | String | 255 | Número do Documento/Seu Número |
| dataEmissao | Date | | Data de emissão do título |
| dataVencimento | Date | | Data de vencimento do título |
| valorTitulo | Double | | Valor do Título |
| codPortador | String | 255 | Código do Portador |
| nomePortador | String | 255 | Nome do Portador |
| tipoCobrança | String | 255 | Descrição do tipo de cobrança, caso não possuir, retornar NULL |
| codTipoTitulo | String | 255 | Código do Tipo de Título |
| nomeTipoTitulo | String | 255 | Nome do Tipo de Título |
| codCliente | String | 255 | Código do Cliente do Título |
| nomeCliente | String | 255 | Nome do Cliente do Título |

Lista de Parâmetros:

|_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| :pCodEmpresa | String/Integer | 10 | (opcional) Código da empresa no ERP |
| :pDataVectoIni | Date | | Data de Vencimento Inicial |
| :pDataVectoFim | Date | | Data de Vencimento Final |
| :pCodCliente | String | 255 | Código do cliente |
| :pCodTitulo | String | 255 | Código do Título |
| :pUsuarioInterno | Integer | | Usuário Interno Logado (0 - Não / 1 - Sim (Representante ou Cliente)) |
| #REPRESENTANTE - REPRESNULL | String | 255 | Lista de código dos Representantes |
| #PORTADOR - PORTNULL | String | 255 | Lista de código dos Portadores |
| #TIPOTITULO - TIPO_TITULONULL | String | 255 | Lista de código dos Tipos de Título |