Integração ISSIntel
1
2
Integração ISSIntel - Comunicando com o Sistema de Gestão do Município
1.1
Integração ISSIntel: O que é
4
1.2
Status atual
5
1.3
Etapas
6
1.4
Informações técnicas
7
FAQ
2.1
Como o sistema lida com o "nao pagamento" do ISS?
11
2.2
O ISSIntel envia informação sobre em qual banco o pagamento foi feito?
12
2.3
Como o meu sistema vai acompanhar as atualizações do cadastro de
contribuintes?
13
Integração ISSIntel Comunicando com o Sistema
de Gestão do Município
Integração ISSIntel - 3
Integração ISSIntel: O que é
A Integração ISSIntel é um sistema de comunicação via Web Services que envia dados do ISSIntel
sobre escrituração de notas e pagamento de ISS, e dados cadastrais dos contribuintes, para o sistema
de gestão do município. O objetivo é alimentar o sistema da gestão da prefeitura de maneira que esse
fique em dia com a dívida ativa e a contabilidade do município.
Integração ISSIntel - 4
Status atual
A Integração ISSIntel já está em funcionamento.
Porém, cada sistema de gestão de prefeitura precisa passar por um processo de desenvolvimento da
integração do lado deles, e fazer uma homologação (ver a sessão Etapas).
Como o software de gestão do município é de propriedade/licensa do município (da prefeitura ou
empresa terceirizada), é o próprio município que se encarrega esse trabalho. Em geral, o encarregado
pelo sistema do município é uma empresa terceirizada. Nesse caso, existe a possibilidade que a
empresa precise de remuneração pelo trabalho. É importante ressaltar que no caso do encarregado
pelo sistema ser uma empresa terceirizada, por uma questão de segurança eles necessitam de uma
solicitação/autorização formal da prefeitura antes que possam dar início às Etapas.
O ISSIntel não cobra nada extra para oferecer essa integração.
Integração ISSIntel - 5
Etapas
Em geral, quando um município precisa da Integração ISSIntel, ele vai precisar assim que o sistema
entrar em produção. Para darmos todo o apoio a esse objetivo, é necessário dar início às etapas
abaixo assim que o contrato for concluído. Todo o trabalho de homologação é feito no ambiente treino,
o que quer dizer que pode ser feito em paralelo ao checklist e antes da cidade entrar em produção.
(1) Análise da estrutura (API) do serviço
Nessa fase, a documentação do serviço é enviada ao time técnico para que possam avaliar,
questionar, e fazer uma estimativa do trabalho.
(2) Desenvolvimento
Nessa fase, o time técnico da prefeitura faz o desenvolvimento da integração, com o apoio do time de
desenvolvimento ISSIntel. Para dar início ao contato com o time de desenvolvimento do ISSIntel, favor
enviar um email para [email protected].
(3) Homologação
O time técnico faz a homologação oficial do sistema junto com o time de desenvolvimento ISSIntel.
Com o sucesso dessa etapa, o sistema estará pronto para uso.
Integração ISSIntel - 6
Informações técnicas
Informações a serem compartilhadas com o time técnico da prefeitura (ou empresa terceirizada) para
que possam avaliar o tempo de desenvolvimento da integração.
Abaixo vão informaçoes sobre onde encontrar um exemplo do schema, e as especificações de todos
os objetos do serviço.
Exemplo de schema
O exemplo de todo o schema do serviço pode ser encontrado aqui:
https://serio-rs.staging-issintel.com/webservices/issintel/wsdl
Timeframe
Objeto responsávei por passar um intervalo de tempo ou apenas um dia.
Atributos:
- begin_at: Início do periodo. Deve sempre ser informado, caso o interesse seja apenas um dia. Este
atributo deve vir com o dia desejado.
- finish_at: Final do período. Caso o interesse seja apenas um dia. Este atributo pode ser omitido.
Formato: YYYY-MM-DD
Pagination
Objeto responsável por informar a página da atual resposta.
Atributos:
- total: Número total de objetos que a consulta retornou.
- page: Página atual exibida.
- displaying_from: Posição do primeiro objeto na lista.
- displaying_to: Posição do último objeto da lista.
Exemplo:
Requisição retornou 765 objetos e será retornado por página, 50 objetos, neste caso, para exibição da
quinta página resposta deverá ser
<pagination>
<total>765</total>
<page>5</page>
<displaying_from>251</displaying_from>
<displaying_to>300</displaying_from>
</pagination>
Integração ISSIntel - 7
Underwriting
Objeto responsável por exibir as informações de uma escrituração.
Atributos:
- id: Identificador interno do objeto (Chave primária da escrituração)
- cpf_cnpj: Número do documento (CPF/CNPJ) do contribuinte que escriturou
- provider: Valor booleano (0/1) identificando se o contribuinte que escriturou é o provedor do serviço
(caso verdadeiro) ou tomador do serviço (caso falso)
- taxed: Valor booleano (0/1) identificando se a escrituração foi taxada (caso verdadeiro) ou se foi
retida (caso falso)
- state: Atual estado da escrituração
- doc_type: Tipo de documento
- doc_number: Número do documento
- doc_series: Série do documento
- base_value: Valor em centavos do serviço escriturado
- iss_value: Valor em centavos do ISS
- deduction_value: Valor em centavos das deduções
- incidence_at: Data de competência da escrituração
- service_at: Data do serviço prestado
- created_at: Data do lançamento da escrituração
Uid
Objeto curto responsável apenas por exibir o identificador de uma escrituração.
Atributo:
- id: Identificador interno do objeto (Chave primária da escrituração)
Stub
Objeto responsável por exibir as informações de uma guia.
Atributos:
- id: Identificador interno do objeto (Chave primária da guia)
- cpf_cnpj: Número do documento (CPF/CNPJ) do contribuinte responsável pela guia
- bank_code: Número de retorno do banco
- paid_at: Data de pagamento da guia
- expires_at: Data de vencimento da guia
- iss_value: Valor em centavos do ISS
- fine_value: Valor em centavos da multa
- interest_value: Valor em centavos dos juros
- deduction_value: Valor em centavos das deduções
- underwriting_list: Lista de objetos uid, representando todas as escriturações vinculadas a guia
Integração ISSIntel - 8
Underwriting List
Objeto responsável por manter uma lista de objetos uid.
Underwritings
Objeto responsável por manter uma lista de objetos underwriting.
Integração ISSIntel - 9
FAQ
Integração ISSIntel - 10
Como o sistema lida com o "nao pagamento" do ISS?
O ISSIntel envia informação sobre todas as escriturações e todas as guias pagas do contribuinte.
Cada guia paga é associada a uma ou mais escriturações. Escriturações não associadas a guias estão
em falta de pagamento.
Integração ISSIntel - 11
O ISSIntel envia informação sobre em qual banco o pagamento foi feito?
Sim.
Integração ISSIntel - 12
Como o meu sistema vai acompanhar as atualizações do cadastro de
contribuintes?
Toda atualização de cadastro de contribuinte após a implantação do ISSIntel no município terá que ser
realizada tanto no ISSIntel quanto também em qualquer outro sistema que a prefeitura mantenha.
Essa duplicação de esforço é normal quando uma entidade usa sistemas independentes, mas como
vantagem a prefeitura tem ao seu dispor um sistema altamente especializado para o incremento da
arrecadação de ISS.
Integração ISSIntel - 13