12
1 Manual de Integração – Versão 1.0 – 14 de Maio de 2014 GOVERNO DO ESTADO DE RONDÔNIA AGÊNCIA DE DEFESA SANITÁRIA AGROSILVOPASTORIL DO ESTADO DE RONDÔNIA IDARON MANUAL DE INTEGRAÇÃO DO SIAFRO À SOFTWARE DE TERCEIROS Versão 1.0 Porto Velho, 14 de maio de 2014.

MANUAL DE INTEGRAÇÃO DO SIAFRO À SOFTWARE DE … · Manual de Integração ... (Agência de Defesa Sanitária Agrosilvopastoril do Estado de Rondônia) para ser utilizado nas revendas

Embed Size (px)

Citation preview

Page 1: MANUAL DE INTEGRAÇÃO DO SIAFRO À SOFTWARE DE … · Manual de Integração ... (Agência de Defesa Sanitária Agrosilvopastoril do Estado de Rondônia) para ser utilizado nas revendas

1 Manual de Integração – Versão 1.0 – 14 de Maio de 2014

GOVERNO DO ESTADO DE RONDÔNIA AGÊNCIA DE DEFESA SANITÁRIA AGROSILVOPASTORIL DO ESTADO DE RONDÔNIA – IDARON

MANUAL DE INTEGRAÇÃO DO SIAFRO À SOFTWARE DE

TERCEIROS

Versão 1.0

Porto Velho, 14 de maio de 2014.

Page 2: MANUAL DE INTEGRAÇÃO DO SIAFRO À SOFTWARE DE … · Manual de Integração ... (Agência de Defesa Sanitária Agrosilvopastoril do Estado de Rondônia) para ser utilizado nas revendas

2 Manual de Integração – Versão 1.0 – 14 de Maio de 2014

ÍNDICE

1. FINALIDADE

2. CONCEITOS INICIAIS

3. DEFINIÇÃO DE ENTIDADES EXTERNAS

4. DEFINIÇÃO DE ENTIDADES DO RELATÓRIO

5. FORMATAÇÃO

6. VALIDAÇÃO

7. RELAÇÃO DE LINKS

8. RECEBIMENTO DO RELATÓRIO E TESTES DE VALIDAÇÃO

Page 3: MANUAL DE INTEGRAÇÃO DO SIAFRO À SOFTWARE DE … · Manual de Integração ... (Agência de Defesa Sanitária Agrosilvopastoril do Estado de Rondônia) para ser utilizado nas revendas

3 Manual de Integração – Versão 1.0 – 14 de Maio de 2014

1. FINALIDADE

O SIAFRO (Sistema de Fiscalização do Comércio de Agrotóxicos do Estado de Rondônia) é um software fornecido

pela IDARON (Agência de Defesa Sanitária Agrosilvopastoril do Estado de Rondônia) para ser utilizado nas revendas

de agrotóxicos com objetivo de informar eletronicamente esta Agência de todas as embalagens comercializadas e

receituários emitidos. Conforme definido na portaria nº 284 de 08 de Junho de 2011, o relatório é transmitido

mensalmente pela internet.

Esta documentação visa possibilitar que softwares de terceiros consigam gerar o relatório eletrônico compatível com

o SIAFRO e estes sejam também entregues pelas revendas de produtos agrotóxicos mensalmente de forma

eletrônica à IDARON.

O período utilizado na implementação NÃO isenta a revenda de agrotóxico de manter em dias as prestações de

informações à IDARON via SIAFRO.

2. CONCEITOS INICIAIS

O conceito mais básico desta documentação é o de RELATÓRIO. O relatório compreende o período de um mês e a

informação contida nele deve detalhar todas as comercializações de produtos agrotóxicos realizadas na revenda. A

forma de descrever as comercializações realizadas é o RECEITUÁRIO AGRONÔMICO. Respeitando a portaria de

instituição do SIAFRO, o relatório, uma vez incluídas todas as receitas emitidas no período, deve ser enviado

eletronicamente à IDARON até o quinto dia útil do mês subsequente. O formato do arquivo é XML (eXtensible

Markup Language), sendo que segue com esta documentação um exemplo comentado para maior compreensão das

definições.

3. DEFINIÇÃO DE ENTIDADES EXTERNAS

Define-se como entidades externas as listas que fornecerão as identificações (ID) para a composição do relatório.

Essas listas estarão disponíveis em endereço fixo na Internet em formato XML e serão atualizadas tantas vezes

quanto necessário para incluir os registros de novos produtos, diagnósticos e outros. Os hiperlinks para estas listas

estão definidos na seção 7, deste manual. São elas:

Agrotóxicos

Pragas

Tipos de pragas

Culturas

Diagnósticos (Agrotóxicos/Culturas/Pragas)

Volumes

Tipos de Aplicação

Embalagens

Agrotóxicos/Embalagens

Municípios

Estados (UF)

Page 4: MANUAL DE INTEGRAÇÃO DO SIAFRO À SOFTWARE DE … · Manual de Integração ... (Agência de Defesa Sanitária Agrosilvopastoril do Estado de Rondônia) para ser utilizado nas revendas

4 Manual de Integração – Versão 1.0 – 14 de Maio de 2014

3.1 AGROTÓXICOS

É a lista de produtos agrotóxicos que contém os produtos cadastrados na IDARON, bem como o status do produto

(apto para comercialização, inapto ou cancelado). Observação: O status do produto é informação essencial para

comercialização correta do produto e pode, em certos casos, ser alterada diariamente. São campos desta lista:

NOME DO CAMPO TIPO DESCRIÇÃO ID_AGROTOXICO INTEIRO Campo de identificação do produto agrotóxico

NM_MARCA_COMERCIAL TEXTO/STRING Nome da marca comercial do produto

NR_REGISTRO_MAPA TEXTO/STRING Número de registro do produto no MAPA (Ministério da Agricultura, Pecuária e abastecimento)

DS_SITUACAO TEXTO/STRING Descrição da situação do produto

3.2 PRAGAS

Lista de pragas baseada na lista do MAPA. Contém o nome vulgar e nome científico. São campos desta lista:

NOME DO CAMPO TIPO DESCRIÇÃO ID_PRAGA INTEIRO Campo de identificação da praga

NM_VULGAR TEXTO/STRING Nome vulgar da praga

NM_CIENTIFICO TEXTO/STRING Nome científico da praga

ID_TIPO_PRAGA INTEIRO Identificação do tipo de praga (doença, inseto ou planta). Ver próxima lista

3.3 TIPOS DE PRAGAS

Lista dos tipos de pragas. Esta lista é vinculada a lista de Pragas (3.2). São campos desta lista:

NOME DO CAMPO TIPO DESCRIÇÃO ID_TIPO_PRAGA INTEIRO Campo de identificação do tipo de praga

NM_TIPO_PRAGA TEXTO/STRING Nome do tipo de praga

3.4 CULTURAS

Lista de culturas (espécies). São campos desta lista:

NOME DO CAMPO TIPO DESCRIÇÃO ID_CULTURA INTEIRO Campo de identificação da cultura

NM_CULTURA TEXTO/STRING Nome da cultura

3.5 DIAGNÓSTICOS

Lista de diagnósticos cadastrados na IDARON. Essa lista fornece as informações que serão usadas na validação do

relatório. Atenção para o composição dos identificadores de acordo com o que já foi listado acima. O cadastro de

receituários em desacordo aos diagnósticos permitidos pode gerar advertência/multa para a revenda de agrotóxicos.

São campos desta lista:

NOME DO CAMPO TIPO DESCRIÇÃO ID_AGROTOXICO INTEIRO Campo de identificação do produto agrotóxico

ID_CULTURA INTEIRO Campo de identificação da cultura

ID_PRAGA INTEIRO Campo de identificação da praga

NR_INTERVALO INTEIRO Valor em dias do intervalo de segurança para a aplicação do produto na cultura/praga indicada

Page 5: MANUAL DE INTEGRAÇÃO DO SIAFRO À SOFTWARE DE … · Manual de Integração ... (Agência de Defesa Sanitária Agrosilvopastoril do Estado de Rondônia) para ser utilizado nas revendas

5 Manual de Integração – Versão 1.0 – 14 de Maio de 2014

3.6 VOLUMES

Lista de volumes disponíveis para ser usado na recomendação do engenheiro agrônomo (litros, quilos ou metros),

indicando a quantidade do produto a ser adquirida (NÃO CONFUNDIR COM EMBALAGEM QUE SERÁ DESCRITO MAIS

ADIANTE). São campos desta lista:

NOME DO CAMPO TIPO DESCRIÇÃO ID_VOLUME INTEIRO Campo de identificação do volume

NM_VOLUME TEXTO/STRING Nome do volume

3.7 TIPOS DE APLICAÇÃO

Lista contendo os tipos de aplicações (terrestre ou aérea). São campos desta lista:

NOME DO CAMPO TIPO DESCRIÇÃO ID_TIPO_APLICACAO INTEIRO Campo de identificação do tipo de aplicação

NM_TIPO_APLICACAO TEXTO/STRING Nome do tipo de aplicação

3.8 EMBALAGENS

Lista de embalagens cadastradas na IDARON. São campos desta lista:

NOME DO CAMPO TIPO DESCRIÇÃO ID_EMBALAGEM INTEIRO Campo de identificação da embalagem

NM_EMBALAGEM TEXTO/STRING Nome da embalagem

ID_VOLUME INTEIRO Campo de identificação do tipo da embalagem, sendo: (1) litro ou (2) quilo

3.9 AGROTÓXICOS/EMBALAGENS

Lista que descreve as embalagens existente de cada produto agrotóxico através da associação de campos de

identificação. Essa lista fornece as informações que serão usadas na validação do relatório. O cadastro de

receituários em desacordo com as embalagens disponíveis para cada produto pode gera advertência/multa para a

revenda de agrotóxico. São campos desta lista:

NOME DO CAMPO TIPO DESCRIÇÃO ID_AGROTOXICO INTEIRO Campo de identificação do produto agrotóxico

ID_EMBALAGEM INTEIRO Campo de identificação da embalagem

3.10 MUNICÍPIOS

Lista de municípios com identificadores em acordo com a lista oficial do IBGE. Somente contém as informações de

distritos/municípios do estado de Rondônia. São campos desta lista:

NOME DO CAMPO TIPO DESCRIÇÃO ID_MUNICIPIO TEXTO/STRING Campo de identificação (tamanho 9) do município/distrito

NM_MUNICIPIO TEXTO/STRING Nome do distrito/município

ID_UF TEXTO/STRING Campo de identificação (tamanho 2) do estado/UF

Page 6: MANUAL DE INTEGRAÇÃO DO SIAFRO À SOFTWARE DE … · Manual de Integração ... (Agência de Defesa Sanitária Agrosilvopastoril do Estado de Rondônia) para ser utilizado nas revendas

6 Manual de Integração – Versão 1.0 – 14 de Maio de 2014

3.11 ESTADO

Lista de estados/UF com identificadores em acordo com a lista oficial do IBGE. São campos desta lista:

NOME DO CAMPO TIPO DESCRIÇÃO ID_ESTADO TEXTO/STRING Campo de identificação (tamanho 2) do estado/UF

SG_SIGLA TEXTO/STRING Sigla do estado/UF (tamanho 2)

NM_ESTADO TEXTO/STRING Nome do estado/UF

4. DEFINIÇÃO DE ENTIDADES DO RELATÓRIO

Define-se como entidades do relatório as que se auto definirão dentro do arquivo XML do relatório através de tags

(ou grupos/subgrupos delas), construindo a informação que será enviada. Para uma melhor compreensão, vide

documento XML de exemplo anexo a esta documentação. Entidades:

Empresa

Receituário

Agrotóxico

Embalagem

4.1 EMPRESA

Recebe as informações da revenda de agrotóxico. São campos dessa entidade:

NOME DO CAMPO TIPO DESCRIÇÃO NR_CNPJ NUMÉRICO CNPJ da revenda de agrotóxicos, tamanho 14. Sem pontos,

traços ou barras. Campo obrigatório

NM_RAZAO_SOCIAL TEXTO/STRING Razão social, tamanho máximo 255. Campo obrigatório

NM_FANTASIA TEXTO/STRING Nome fantasia, tamanho máximo 255. Campo obrigatório

NM_PROPRIETARIO TEXTO/STRING Nome completo do proprietário da revenda, tamanho máximo 100.

DS_ENDERECO TEXTO/STRING Endereço (logradouro, número), tamanho máximo 255. Campo obrigatório

DS_COMPLEMENTO TEXTO/STRING Complemento ao endereço, tamanho máximo 50

DS_BAIRRO TEXTO/STRING Bairro, tamanho máximo 50. Campo obrigatório

ID_MUNICIPIO TEXTO/STRING Identificação do município, tamanho 9 (item 3.10). Campo obrigatório

NR_CEP NUMÉRICO Número do CEP, tamanho 8. Campo obrigatório

NR_INSCRICAO_ESTADUAL TEXTO/STRING Número da inscrição estadual, tamanho máximo 100

NM_SITE_EMPRESA TEXTO/STRING Site da empresa, tamanho máximo 50

NM_EMAIL_EMPRESA TEXTO/STRING E-mail principal da empresa, tamanho máximo 50

NR_TELEFONE NUMÉRICO Telefone principal, sem traços ou parênteses. Tamanho 8. Campo obrigatório

NR_FAX NUMÉRICO Número do fax, sem traços ou parênteses. Tamanho 8

Page 7: MANUAL DE INTEGRAÇÃO DO SIAFRO À SOFTWARE DE … · Manual de Integração ... (Agência de Defesa Sanitária Agrosilvopastoril do Estado de Rondônia) para ser utilizado nas revendas

7 Manual de Integração – Versão 1.0 – 14 de Maio de 2014

4.2 RECEITUÁRIO

Recebe as informações do receituário. Como característica do documento XML, essa entidade (em forma de tags) se

repetirá quantas vezes for necessário para informar todos os receituários emitidos e as comercializações de

embalagens realizadas. São campos dessa entidade:

NOME DO CAMPO TIPO DESCRIÇÃO NR_RECEITUARIO TEXTO/STRING Número do receituário agronômico, tamanho máximo 100.

Campo obrigatório

NR_ART TEXTO/STRING Número da ART (Anotação de responsabilidade técnica), tamanho máximo 100

DT_EMISSAO DATA Data da emissão do receituário (XX/XX/XXXX). Campo obrigatório

NR_CPF_PRODUTOR NUMÉRICO Número do CPF do produtor que está adquirindo o produto agrotóxico. Se pessoa jurídica, este campo pode receber o CNPJ da empresa. O CPF/CNPJ será validado antes de ser recebido na base de dados da IDARON. Não incluir pontos, traços e barras. Campo obrigatório

NM_PRODUTOR TEXTO/STRING Nome completo do produtor ou nome da empresa. Tamanho máximo 250. Campo obrigatório

NM_PROPRIEDADE TEXTO/STRING Nome da propriedade onde será feita a aplicação. Tamanho máximo 250

DS_LOCAL_APLICACAO TEXTO/STRING Endereço da aplicação, tamanho máximo 500. Campo obrigatório

ID_MUNICIPIO TEXTO/STRING Identificação do município/distrito de aplicação, tamanho 9 (item 3.10). Campo obrigatório

ID_ESTADO TEXTO/STRING Identificação do estado de aplicação, tamanho 2 (item 3.11). Campo obrigatório

VL_AREA_APLICACAO TEXTO/STRING Área de aplicação, tamanho máximo 50

NR_CPF_PROFISSIONAL NUMÉRICO Número do CPF do profissional responsável pela emissão do receituário (engenheiro agrônomo), tamanho 11. Não incluir pontos, traços e barras. Campo obrigatório

NM_PROFISSIONAL TEXTO/STRING Nome de profissional responsável pela emissão do receituário, tamanho máximo 250. Campo obrigatório

NR_CREA_PROFISSIONAL TEXTO/STRING Número do registro do profissional no CREA, tamanho máximo 50. Campo obrigatório

4.3 AGROTÓXICO

Esta entidade é submissa a entidade anterior (Receituário) e trará a informação do produto comercializado e as

informações de diagnóstico realizada pelo profissional (engenheiro agrônomo). São campos dessa entidade:

NOME DO CAMPO TIPO DESCRIÇÃO ID_AGROTOXICO INTEIRO Identificador do produto agrotóxico (item 3.1).

Campo obrigatório

ID_CULTURA INTEIRO Identificador da cultura na qual será feita aplicação (item 3.4). Campo obrigatório

ID_PRAGA INTEIRO Identificador da praga para qual será feita aplicação (item 3.2). Campo obrigatório

VL_DOSE TEXTO/STRING Descrição da dose recomendada pelo profissional, tamanho máximo 100. Campo obrigatório

Page 8: MANUAL DE INTEGRAÇÃO DO SIAFRO À SOFTWARE DE … · Manual de Integração ... (Agência de Defesa Sanitária Agrosilvopastoril do Estado de Rondônia) para ser utilizado nas revendas

8 Manual de Integração – Versão 1.0 – 14 de Maio de 2014

NR_APLICACAO_DOSE INTEIRO Quantidade de aplicações da dose recomendada. Campo obrigatório

ID_INDICACAO_VOLUME INTEIRO Identificador do tipo de volume (litro, quilo ou metro) recomendado do produto (item 3.6). Campo obrigatório

NR_INDICACAO_VOLUME DECIMAL Quantidade a ser adquirida do produto no volume descrito no campo acima, aceita até 3 casas decimais. Campo obrigatório

ID_TIPO_APLICACAO INTEIRO Identificador do tipo de aplicação (terrestre ou aérea) (item 3.7). Campo obrigatório

NR_INTERVALO_SEGURANCA INTEIRO Intervalo de segurança em dias. Campo obrigatório

4.4 EMBALAGEM

Esta entidade é submissa a entidade anterior (Agrotóxico) e trará a informação das embalagens comercializadas do

produto descrito. São campos dessa entidade:

NOME DO CAMPO TIPO DESCRIÇÃO VL_QUANTIDADE INTEIRO Quantidade da embalagem adquirida.

Campo obrigatório

ID_EMBALAGEM INTEIRO Identificador do tipo da embalagem (item 3.8). Campo obrigatório

5. FORMATAÇÃO

O formato do relatório é o XML (eXtensible Markup Language), linguagem que é capaz de descrever flexivelmente

diversos tipos de dados e independe da linguagem de programação utilizada. Para que o relatório seja recebido ele

terá que obedecer as regras de formatação e as nomenclaturas e valores fornecidos. TODAS AS TAGS (ELEMENTOS)

E ATRIBUTOS DESCRITOS DEVERÃO CONSTAR NO RELATÓRIO, AINDA QUE O VALOR SEJA VAZIO (NO CASO DOS

CAMPOS DE VALOR NÃO OBRIGATÓRIOS).

5.1 TAG INTRODUTÓRIA E TAG RAIZ

O elemento introdutório (tag) do documento descreve seu tipo e versão. Ele é seguido pelo elemento (tag) raiz que

conterá todo o conteúdo do relatório. Importante: nenhuma dessas tags se repete. Demonstração:

A tag RELATORIO conterá dois atributos importantes e obrigatórios:

NR_MES: Mês (numérico) base do relatório, tamanho 2.

NR_ANO: Ano base de relatório, tamanho 4.

5.2 TAGS EMPRESA E RECEITAS

<?xml version=”1.0” encoding=”utf-8” standalone=”yes” ?> <RELATORIO NR_MES=”XX” NR_ANO=”XXXX”>

... </RELATORIO>

Page 9: MANUAL DE INTEGRAÇÃO DO SIAFRO À SOFTWARE DE … · Manual de Integração ... (Agência de Defesa Sanitária Agrosilvopastoril do Estado de Rondônia) para ser utilizado nas revendas

9 Manual de Integração – Versão 1.0 – 14 de Maio de 2014

Dentro da tag raiz RELATORIO haverá dois elementos que conterão as principais informações do relatório. O

primeiro é o elemento EMPRESA que receberá os campos descritos no item 4.1 em forma de elementos contidos em

si próprio. O segundo elemento é RECEITAS, que conterá os elementos que descreverão os receituários. A tag

EMPRESA e a tag RECEITAS não se repetem no relatório. Demonstração:

5.3 RECEITUÁRIO

Dentro da tag RECEITAS, para descrever todos os receituários emitidos na revenda, se repetirá tantas vezes quanto

necessário a tag RECEITUARIO. Em cada ocorrência, constarão atributos em conformidade com o item 4.2.

Demonstração:

<?xml version=”1.0” encoding=”utf-8” standalone=”yes” ?> <RELATORIO NR_MES=”XX” NR_ANO=”XXXX”>

<EMPRESA> <NR_CNPJ>XXXXXXXXXXXXXX</NR_CNPJ> <NM_RAZAO_SOCIAL>Razão Social</NM_RAZAO_SOCIAL> <NM_FANTASIA>Nome Fantasia</NM_FANTASIA> <NM_PROPRIETARIO>Fulano de Tal</NM_PROPRIETARIO> <DS_ENDERECO>Rua Tal, 1000</DS_ENDERECO> <DS_COMPLEMENTO>Próximo da praça</DS_COMPLEMENTO> <DS_BAIRRO>Centro</DS_BAIRRO> <ID_MUNICIPIO>XXXXXXXXX</ID_MUNICIPIO> <NR_CEP>XXXXXXXX</NR_CEP> <NR_INSCRICAO_ESTADUAL>XXXXXXX</NR_INSCRICAO_ESTADUAL> <NM_SITE_EMPRESA>www.meusite.com.br</NM_SITE_EMPRESA> <NM_EMAIL_EMPRESA>[email protected]</NM_EMAIL_EMPRESA> <NR_TELEFONE>XXXXXXXX</NR_TELEFONE> <NR_FAX>XXXXXXXX</NR_FAX> </EMPRESA> <RECEITAS>

... </RECEITAS>

</RELATORIO>

Page 10: MANUAL DE INTEGRAÇÃO DO SIAFRO À SOFTWARE DE … · Manual de Integração ... (Agência de Defesa Sanitária Agrosilvopastoril do Estado de Rondônia) para ser utilizado nas revendas

10 Manual de Integração – Versão 1.0 – 14 de Maio de 2014

5.4 AGROTÓXICOS

Para a descrição do produtos comercializados no receituário será adicionado a tag AGROTOXICOS dentro de cada

ocorrência da tag RECEITUARIO. E dentro da tag AGROTOXICOS para cada produto haverá a ocorrência da tag

AGROTOXICO. Demonstração:

<?xml version=”1.0” encoding=”utf-8” standalone=”yes” ?> <RELATORIO NR_MES=”XX” NR_ANO=”XXXX”>

<EMPRESA>

... </EMPRESA> <RECEITAS>

<RECEITUARIO NR_RECEITUARIO=”XXXXXX” NR_ART=”XXXXXXXXXX” DT_EMISSAO=”XX/XX/XXXX” NR_CPF_PRODUTOR=”XXXXXXXXXXX” NM_PRODUTOR=”Ciclano da Silva” NM_PROPRIEDADE=”Fazenda Pipoca” DS_LOCAL_APLICACAO=”LINHA XXX LOTE XX GLEBA XX” ID_MUNICIPIO=”XXXXXXXXX” ID_ESTADO=”XX” VL_AREA_APLICACAO=”X ha” NR_CPF_PROFISSIONAL=”XXXXXXXXXXX” NM_PROFISSIONAL=”Beltrano Júnior” NR_CREA_PROFISSIONAL=”XXXX-X”>

</RECEITUARIO> </RECEITAS>

</RELATORIO>

<?xml version=”1.0” encoding=”utf-8” standalone=”yes” ?> <RELATORIO NR_MES=”XX” NR_ANO=”XXXX”>

<EMPRESA>

... </EMPRESA> <RECEITAS>

<RECEITUARIO NR_RECEITUARIO=”XXXXXX” NR_ART=”XXXXXXXXXX” DT_EMISSAO=”XX/XX/XXXX” NR_CPF_PRODUTOR=”XXXXXXXXXXX” NM_PRODUTOR=”Ciclano da Silva” NM_PROPRIEDADE=”Fazenda Pipoca” DS_LOCAL_APLICACAO=”LINHA XXX LOTE XX GLEBA XX” ID_MUNICIPIO=”XXXXXXXXX” ID_ESTADO=”XX” VL_AREA_APLICACAO=”X ha” NR_CPF_PROFISSIONAL=”XXXXXXXXXXX” NM_PROFISSIONAL=”Beltrano Júnior” NR_CREA_PROFISSIONAL=”XXXX-X”> <AGROTOXICOS>

<AGROTOXICO ID_AGROTOXICO=”XXXX” ID_CULTURA=”XX” ID_PRAGA=”XXX” VL_DOSE=”XXXXXXXXX” NR_APLICACAO_DOSE=”” ID_INDICACAO_VOLUME=”X” NR_INDICACAO_VOLUME=”X” ID_TIPO_APLICACAO=”X” NR_INTERVALO_SEGURANCA=”XX”>

</AGROTOXICO> </AGROTOXICOS>

</RECEITUARIO> </RECEITAS>

</RELATORIO>

Page 11: MANUAL DE INTEGRAÇÃO DO SIAFRO À SOFTWARE DE … · Manual de Integração ... (Agência de Defesa Sanitária Agrosilvopastoril do Estado de Rondônia) para ser utilizado nas revendas

11 Manual de Integração – Versão 1.0 – 14 de Maio de 2014

5.5 EMBALAGENS

Para a descrição das embalagens dos produtos comercializados no receituário será adicionado a tag EMBALAGENS

dentro de cada ocorrência da tag AGROTOXICO. E dentro da tag EMBALAGENS para cada embalagem de tamanho

diferente haverá a ocorrência da tag EMBALAGEM. Demonstração:

Essa estrutura demonstrada descreve a composição do relatório no formato XML. Tantos receituários quantos forem

necessários serem descritos, somente necessitarão da repetição da tag RECEITUARIO, seus atributos e elementos

submissos com o preenchimento dos valores a serem informados.

6. VALIDAÇÃO

Para que o relatório seja recebido na base de dados da IDARON, ele passará por uma sequência de validações. Segue

abaixo a ordem de análise:

XML – A validação XML se dará conforme as regras universais estabelecidas para a boa formatação de um

arquivo XML. O World Wide Web Consortium (W3C) é o órgão responsável pela padronização. Links

pertinentes as regras XML constarão na próxima seção.

Existência dos elementos – Verificação da existência dos elementos e atributos em ordem correta e

dependência adequada.

Tipos – Validação dos tipos dos campos conforme seção 4.

Tamanho dos campos – Verificação dos dados nos campos que tiveram seu tamanho definido na seção 4.

<?xml version=”1.0” encoding=”utf-8” standalone=”yes” ?> <RELATORIO NR_MES=”XX” NR_ANO=”XXXX”>

<EMPRESA>

... </EMPRESA> <RECEITAS>

<RECEITUARIO NR_RECEITUARIO=”XXXXXX” NR_ART=”XXXXXXXXXX” DT_EMISSAO=”XX/XX/XXXX” NR_CPF_PRODUTOR=”XXXXXXXXXXX” NM_PRODUTOR=”Ciclano da Silva” NM_PROPRIEDADE=”Fazenda Pipoca” DS_LOCAL_APLICACAO=”LINHA XXX LOTE XX GLEBA XX” ID_MUNICIPIO=”XXXXXXXXX” ID_ESTADO=”XX” VL_AREA_APLICACAO=”X ha” NR_CPF_PROFISSIONAL=”XXXXXXXXXXX” NM_PROFISSIONAL=”Beltrano Júnior” NR_CREA_PROFISSIONAL=”XXXX-X”> <AGROTOXICOS>

<AGROTOXICO ID_AGROTOXICO=”XXXX” ID_CULTURA=”XX” ID_PRAGA=”XXX” VL_DOSE=”XXXXXXXXX” NR_APLICACAO_DOSE=”” ID_INDICACAO_VOLUME=”X” NR_INDICACAO_VOLUME=”X” ID_TIPO_APLICACAO=”X” NR_INTERVALO_SEGURANCA=”XX”>

<EMBALAGENS> <EMBALAGEM VL_QUANTIDADE=”X” ID_EMBALAGEM=”XX”></EMBALAGEM>

</EMBALAGENS> </AGROTOXICO>

</AGROTOXICOS> </RECEITUARIO>

</RECEITAS> </RELATORIO>

Page 12: MANUAL DE INTEGRAÇÃO DO SIAFRO À SOFTWARE DE … · Manual de Integração ... (Agência de Defesa Sanitária Agrosilvopastoril do Estado de Rondônia) para ser utilizado nas revendas

12 Manual de Integração – Versão 1.0 – 14 de Maio de 2014

Consistência das entidades externas – Validação dos campos que utilizam identificação fornecida pela lista

descrita na seção 3.

Produtos por receita – Considerando que cada receituário deve ser destinado para a resolução de um

problema fitossanitário específico (Decreto 13.563/08, Art. 21 § 6.), a adição de um segundo produto ao

receituário somente é aceitável em casos de adjuvantes/espalhante adesivo, ou seja, produto auxiliar ao

produto principal.

Diagnósticos e Embalagens – Verificação se o diagnóstico do receituário seguiu os dados da lista descrita no

item 3.5 e se a embalagem vendida ao produtor existe na lista descrita no item 3.9.

7. RELAÇÃO DE LINKS

Tabela de links fixos das entidades externas:

LISTA LINK Agrotóxicos http://www.idaron.ro.gov.br/SIAFRO/XML/agrotoxicos.xml

Pragas http://www.idaron.ro.gov.br/SIAFRO/XML/pragas.xml

Tipos de pragas http://www.idaron.ro.gov.br/SIAFRO/XML/tipos_pragas.xml

Culturas http://www.idaron.ro.gov.br/SIAFRO/XML/culturas.xml

Diagnósticos http://www.idaron.ro.gov.br/SIAFRO/XML/diagnosticos.xml

Volumes http://www.idaron.ro.gov.br/SIAFRO/XML/volumes.xml

Tipos de aplicação http://www.idaron.ro.gov.br/SIAFRO/XML/tipos_aplicacao.xml

Embalagens http://www.idaron.ro.gov.br/SIAFRO/XML/embalagens.xml

Agrotóxicos/Embalagens http://www.idaron.ro.gov.br/SIAFRO/XML/agrotoxico_embalagens.xml

Municípios http://www.idaron.ro.gov.br/SIAFRO/XML/municipios.xml

Estados http://www.idaron.ro.gov.br/SIAFRO/XML/estados.xml

Tabela de links para consulta:

DESCRIÇÃO LINK XML básico (em inglês) http://www.w3schools.com/xml/

Documentação XML (em inglês) http://www.w3.org/XML/

IDARON (site oficial) http://www.idaron.ro.gov.br

SIAFRO (site oficial) http://www.idaron.ro.gov.br/SIAFRO

AGROFIT (registro de agrotóxicos federal/MAPA)

http://agrofit.agricultura.gov.br/agrofit_cons/principal_agrofit_cons

8. RECEBIMENTO DO RELATÓRIO E TESTES DE VALIDAÇÃO

O recebimento do relatório da revenda de agrotóxico se dará em sistema on-line que será disponibilizado no site da

IDARON (http://www.idaron.ro.gov.br) em área restrita, de acesso exclusivo da revenda.

A IDARON, através de setor específico, estará disponível para responder dúvidas e executar testes de validação em

conjunto com as empresas desenvolvedoras e/ou revendas de agrotóxicos, lembrando que relatórios que não

cumprirem as regras deste manual não serão recebidos em nossa base de dados. Os testes de validação deverão ser

enviados para IDARON (Setor de Informática – Desenvolvimento) através dos endereços de e-mail abaixo:

[email protected] (principal)

[email protected]

Os resultados serão relatados e enviados aos remetentes. Telefones para contato: 69 3216-5264 / 69 8486-9866.