Introdução
Na era da informação digital, a integração de sistemas é essencial para otimizar processos e garantir eficiência operacional. Nesse contexto, a utilização de APIs (Application Programming Interfaces) tornou-se uma prática fundamental para facilitar a troca de dados entre diferentes plataformas e sistemas, permitindo comunicação eficiente e em tempo real.
Nosso compromisso é fornecer uma solução de integração de alta qualidade, alinhada às necessidades específicas de nossos clientes, garantindo uma experiência fluida e segura em todas as etapas do processo. Por meio da API, os dados do cliente podem ser atualizados automaticamente, mantendo as informações precisas e sincronizadas em todas as plataformas.
A segurança é prioridade em todas as etapas da integração. Nossa API utiliza os mais altos padrões de proteção, incluindo protocolos avançados de criptografia e autenticação de usuário, assegurando que os dados sensíveis do cliente permaneçam protegidos contra acessos não autorizados.
Fluxo do Processo de Integração
- Disponibilização dos dados: O cliente fornece os dados em formato JSON através de uma API no ambiente webservice.
- Conexão com o Banco de Dados: A API se conecta a um banco de dados seguro, onde as informações do cliente são armazenadas de forma confiável.
- Alimentação das Aplicações Web: O banco de dados abastece as aplicações web da SIGMA, garantindo que os dados do cliente estejam disponíveis para uso em nossos sistemas.
Ao longo deste documento, apresentaremos uma visão detalhada dos pré-requisitos técnicos necessários para iniciar a integração, abordando diferentes bases de dados, além de fornecer orientações sobre como manter a segurança e confiabilidade dos dados em todas as etapas do processo.
Padronização dos dados
- Padrão: Mantenha uma padronização em todos os dados;
- Tipo: Respeitar os tipos dos dados, mesmo que contenha apenas números, se o campo for text, mandar nesse formato;
- Coluna: Todas as colunas da API devem ser idênticas aos da tabela;
- Valores: Todos os valores devem estar em Maiúsculo
Dados Gerais
Base de dados com informações do inventário da unidade, que contém os dados históricos de todas as safras com descritivos a nível de talhão. A consulta deve ser disponibilizada em formato *.json e conter os atributos elencados a seguir
| Coluna | Tipo | Descrição | Exemplo |
|---|---|---|---|
| chave | text | Chave única por talhão? | 2025_7_2211_2_PL2_5_P23_17 |
| safra | int | Ano safra de referência? | 2025 |
| client_id | int | ID do cliente (Fornecido pela SIGMA) ? | 7 |
| unidade | text | Unidade (nome da Usina) ? | USINA EXEMPLO |
| fazenda | text | Número da fazenda? | 2211 |
| setor | text | Identificador do setor? | 2 |
| secao | text | Identificador da seção ? | PL2 |
| bloco | text | Identificador do bloco? | 5 |
| pivo | text | Número do pivô? | P23 |
| talhao | text | Número do talhão? | 17 |
| objetivo | text | Objetivo do talhão? | MOAGEM, MUDA |
| tp_prop | text | Tipo de propriedade? | PROPRIAS, FORNECEDORES |
| desc_faz | text | Nome da fazenda? | FAZENDA 1 |
| desc_cana | text | Descrição da cana? | CANA PLANTA, SOQUEIRA, BISADA, MEIOSI |
| nmro_corte | int | Número do corte? | 1, 2, 3 [...] |
| estagio | text | Estágio detalhado? | 15M, 18M, 2ºC, 3ºCB [...] |
| espacamento | float | Espaçamento plantado (m)? | 1.5 |
| ambiente | text | Classe de ambiente? | A, B, C, D, E, F, G |
| variedade | text | Variedade de cana-de-açúcar? | CTC-4 |
| maturacao | text | Tipo de maturação? | PRECOCE, MEDIA, TARDIA |
| area_bd | float | Área total bruta do talhão (ha)? | 129.2 |
| a_est_moagem | float | Área estimada para moagem (ha)? | 123.5 |
| a_est_muda | float | Área estimada para muda (ha)? | 50.3 |
| a_muda | float | Área real de muda (ha)? | 20.9 |
| area_perda | float | Área perdida/dano (ha)? | 5.2 |
| a_colhida | float | Área colhida (ha)? | 80.1 |
| tch_potencial | float | Toneladas de cana por hectare potencial? | 115 |
| tch_est | float | TCH estimado? | 80.0 |
| tch_rest | float | TCH reestimado? | 20.2 |
| tch_real | float | TCH real? | 96.3 |
| tc_potencial | float | Toneladas de cana potencial? | 20050.7 |
| tc_est | float | Toneladas de cana estimadas? | 12422.7 |
| tc_rest | float | Toneladas de cana reestimadas (?)? | 20.3 |
| tc_real | float | Toneladas de cana reais? | 1059.3 |
| tah | float | Toneladas de açúcar por hectare? | 13.5 |
| tph | float | Toneladas de POL por hectare? | 10.5 |
| dt_plantio | timestamp | Data de plantio? | 15/03/2025 |
| dt_ult_corte | timestamp | Data do último corte? | 15/03/2026 |
| dt_corte_plan | timestamp | Data planejada do próximo corte? | 15/03/2026 |
| dt_corte | timestamp | Data de corte da safra atual ? | 15/03/2026 |
| idade_corte | float | Idade do corte na safra atual (meses)? | 14 |
| atr | float | ATR atual? | 128.3 |
| atr_est | float | ATR estimado? | 125.2 |
| irrigacao | text | Possui irrigação? | NAO, SIM |
| tp_irrigacao | text | Tipo de irrigação? | VINHACA, AGUA RESIDUARIA [...] |
| metodo_irrigacao | text | Método de irrigação? | ASPERSAO, PIVO, LOCALIZADA |
| data_irrigacao | timestamp | Data da última irrigação? | 19/10/2025 |
| lamina | int | Lâmina aplicada? | 1, 2, 3 |
| v_m3 | float | Volume aplicado em m³? | 30 |
| area_daninha | float | Área com daninha voo/drone identificada (ha)? | 4 |
| dt_do_voo_daninha | timestamp | Data do voo/drone que identificou daninha? | 19/10/2025 |
| metros_falhas | float | Metros lineares de falhas? | 500.35 |
| dt_do_voo_falhas | timestamp | Data do voo que identificou falhas? | 19/10/2025 |
| metros_linear_cana | float | Metros lineares de cana plantada? | 71126.22 |
| perdas_col | float | % de perdas na colheita? | 4.0 |
| pisoteio | text | Classificação do pisoteio? | NAO, SIM |
| declividade | float | Declividade média do talhão? | 10.2 |
| aderencia_tratos | float | % de aderência aos tratos culturais? | 25 |
| aderencia_maturacao | float | % de aderência à maturação? | 34 |
| aderencia_preparo | float | % de aderência ao preparo de solo? | 31 |
| aderencia_plantio | float | % de aderência ao plantio? | 90 |
| aderencia_colheita | float | % de aderência à colheita? | 43 |
| aplicacao_regulador | text | Tipo de aplicação? | INIBIDOR, MATURADOR |
| produto_regulador | text | Produto regulador usado? | ETREL, MODDUS [...] |
| dt_aplicacao_regulador | timestamp | Data da aplicação do regulador? | 19/10/2025 |
| classe_de_solo | text | Classe de solo? | LATOSSOLO, ARGISSOLO [...] |
| textura | text | Textura do solo? | ARENOSA, MEDIA, ARGILOSA |
| per_argila | float | % de argila? | 20.3 |
| valor_k | float | Teor de potássio (K)? | 10.1 |
| valor_p | float | Teor de fósforo (P)? | 30 |
| valor_ctc | float | Capacidade de troca catiônica (CTC)? | 60.5 |
| reforma_prev | text | Reforma prevista? | NAO, SIM |
| reforma_real | text | Reforma realizada? | NAO, SIM |
| geada | int | Nível de geada ? | 0, 1, 2, 3 |
Detalhamento dos Campos
chave
Chave única do talhão composta por: safra_client_id_fazenda_setor_secao_bloco_pivo_talhao, se por acaso não tiver algum desse campo, substituir por 0.
safra
Ano da safra agrícola do talhão de referência (ex: 2025 = safra 2025).
client_id
Código da SIGMA para referenciar cada cliente e suas unidades.
unidade
Nome da Usina SIGMA para referenciar ao nome fantasia da Usina/Unidade.
fazenda
Código para referenciar a fazenda.
setor
Código para referenciar o setor, se não houver, use: 0.
secao
Código para referenciar a seção como: SECAO 2, SECAO A. se não houver, use: 0.
bloco
Código para referenciar o bloco, se não houver, use: 0.
pivo
Código para referenciar o pivo, se não houver, use: 0.
talhao
Número para referenciar o talhão.
objetivo
Finalidade do talhão: MOAGEM, MUDA, POUSIO, PLANTIO, MOAGEM/MUDA, REFORMA, PASSAGEM.
tp_prop
Identificação se é uma área: PROPRIAS, PARCERIAS, ACIONISTAS, SPOT, ARRENDAMENTO, FORNECEDORES.
desc_faz
Nome completo da fazenda.
desc_cana
Estágio atual: CANA PLANTA, MEIOSI, SOQUEIRA ou BISADA.
nmro_corte
Contagem de cortes: 1 = cana-planta, 2 = 1º soca, etc.
estagio
Estágio detalhado SEM ESPAÇOS contendo número e letra, sendo o número o estagio ex: 18 (18 meses), 1 ( 1 corte), 2 (2 corte ) [...] e a letra podendo ser M (Mês), C (Corte), CB (Corte Bisado), VER (Verão). Ex: 18M, 1ºC, 2ºCB, 2VER [...], acima de 10ºC usar 10ºC+.
espacamento
Espaçamento planejado no plantio (metros).
ambiente
Classificação de ambiente produtivo: A, B, C, D, E, F, G.
variedade
Código da variedade plantada.
maturacao
Classificação de maturação: PRECOCE, MEDIA, TARDIA.
area_bd
Área total bruta cadastrada no sistema (ha).
a_est_moagem
Área planejada para moagem na safra atual em hectares.
a_est_muda
Área planejada para produção de mudas em hectares.
a_muda
Área efetivamente utilizada para muda em hectares.
area_perda
Área perdida por erosão, inundação, e outras em hectares.
a_colhida
Área já colhida na safra atual em hectares.
tch_potencial
Produtividade potencial estimada para o ambiente/variedade na safra atual.
tch_est
Toneladas de cana por hectare estimadas na safra atual.
tch_rest
TCH reestimado (toneladas/ha) na safra atual.
tch_real
TCH efetivamente colhido na safra atual.
tc_potencial
Total de toneladas de cana potencial na safra atual.
tc_est
Total de toneladas estimadas para o talhão na safra atual.
tc_rest
Toneladas de cana reestimado no campo (estimativa) na safra atual.
tc_real
Total de toneladas efetivamente colhidas na safra atual.
tah
Valor de tonelada de açúcar por hectare.
tph
Toneladas de POL por hectare.
dt_plantio
Data real do plantio (formato DD/MM/AAAA).
dt_ult_corte
Data do último corte realizado (formato DD/MM/AAAA).
dt_corte_plan
Data prevista para o próximo corte (formato DD/MM/AAAA).
dt_corte
Data de corte da safra atual (formato DD/MM/AAAA).
idade_corte
Idade do canavial no momento do corte (meses).
atr
Açúcares Totais Recuperáveis atual (kg/ton).
atr_est
ATR estimado para o corte.
irrigacao
Indica se o talhão é irrigado: NAO ou SIM.
tp_irrigacao
Tipo de fertilizante irrigado: AGUA LIMPA, AGUA RESIDUARIA, VINHACA, VINHACA ENRIQUECIDA.
metodo_irrigacao
Método de aplicação: ASPERSAO, PIVO, GOTEJAMENTO, LOCALIZADA.
data_irrigacao
Data da última aplicação de fertirrigação (formato DD/MM/AAAA).
lamina
Qual lâmina foi aplicada: 1, 2 ou 3.
v_m3
Volume aplicado em metros cúbicos por hectare.
area_daninha
Área identificada com infestação de daninhas.
dt_do_voo_daninha
Data do voo que detectou daninhas (formato DD/MM/AAAA).
metros_falhas
Total de metros lineares com falhas de plantio.
dt_do_voo_falhas
Data do voo que mediu falhas (formato DD/MM/AAAA).
metros_linear_cana
Total de metros lineares de cana plantada.
perdas_col
Percentual de perdas na colheita mecânica.
pisoteio
Classificação se houve pisoteio por máquinas: NAO ou SIM.
declividade
Declividade média do terreno.
aderencia_tratos
Percentual de aderência aos tratos culturais recomendados.
aderencia_maturacao
Percentual de aderência à aplicação de maturadores e inibidores.
aderencia_preparo
Aderência ao preparo de solo.
aderencia_plantio
Aderência às boas práticas de plantio.
aderencia_colheita
Aderência às boas práticas de colheita.
aplicacao_regulador
Tipo de regulador aplicado: INIBIDOR ou MATURADOR.
produto_regulador
Nome comercial do regulador usado.
dt_aplicacao_regulador
Data da aplicação do regulador (formato DD/MM/AAAA).
classe_de_solo
Classificação pedológica principal como: LATOSSOLO, ARGISSOLO, NEOSSOLO [...].
textura
Textura predominante do solo: ARENOSA, MEDIA ou ARGILOSA.
per_argila
Percentual de argila no solo.
valor_k
Teor de potássio (mg/dm³ ou cmolc/dm³).
valor_p
Teor de fósforo (mg/dm³).
valor_ctc
Capacidade de troca catiônica efetiva.
reforma_prev
Indica se o talhão está previsto para reforma na safra.
reforma_real
Indica se a reforma já foi executada.
geada
Indica se a área teve geada, sendo categorizada como 0: Não, 1: leve, 2: moderada, 3: intensa.
Chuvas
Dados meteorológicos coletados nas estações localizadas nas fazendas da unidade. A consulta deve ser disponibilizada em formato *.json e conter os atributos elencados a seguir.
| Coluna | Tipo | Descrição | Exemplo |
|---|---|---|---|
| local | text | Nome da estação de coleta? | Cidade A |
| fazenda | text | Nome da fazenda em que se localiza a estação de coleta? | Fazenda XYZ |
| y_lat | float | Coordenada geográfica. Valor da latitude em graus decimais? | -23.456789 |
| x_long | float | Coordenada geográfica. Valor da longitude em graus decimais? | -46.789012 |
| data | timestamp | Data de coleta? | 15/05/2025 |
| ano | int | Ano da data de coleta? | 2023 |
| mes | int | Mês da data de coleta (1-12)? | 5 |
| semana | int | Semana do ano? | 20 |
| dia | int | Dia do mês da coleta? | 15 |
| precipitacao | float | Valor da precipitação registrada, em milímetros (mm)? | 12.5 |
| temp_media | float | Temperatura média registrada no dia (°C)? | 22.5 |
| temp_min | float | Temperatura mínima registrada no dia (°C)? | 15.5 |
| temp_max | float | Temperatura máxima registrada no dia (°C)? | 37.0 |
| umi_media | float | Umidade média registrada no dia (%)? | 80.6 |
| umi_min | float | Umidade mínima registrada no dia (%)? | 30.2 |
| umi_max | float | Umidade máxima registrada no dia (%)? | 99.9 |
Detalhamento dos Campos
local
Nome identificador da estação meteorológica dentro da unidade/fazenda.
fazenda
Nome completo da fazenda onde a estação está instalada.
y_lat
Latitude da estação em graus decimais (datum WGS84). Valores negativos indicam hemisfério sul.
x_long
Longitude da estação em graus decimais (datum WGS84). Valores negativos indicam hemisfério oeste.
data / ano / mes / semana / dia
Data da medição (formato DD/MM/AAAA) e seus componentes extraídos para facilitar filtros e agrupamentos.
precipitacao
Pluviometria total acumulada no dia (mm), com separador decimal ponto.
temp_media / temp_min / temp_max
Temperaturas registradas em graus Celsius (°C), com uma casa decimal.
umi_media / umi_min / umi_max
Umidade registradas em percentual, com uma casa decimal.
Talhões (geometrias) – Polígonos Georreferenciados
Dados relacionados à base de talhões da usina, polígonos georreferenciados. A consulta deve ser disponibilizada em formato *.json e conter os atributos elencados a seguir.
| Coluna | Tipo | Descrição | Exemplo |
|---|---|---|---|
| chave | text | Identificador único do talhão (ex: fazenda_setor_talhao)? | 7_2211_2_PL2_5_P23_17 |
| client_id | int | Código do cliente fornecido pela sigma? | 7 |
| fazenda | text | Código da fazenda? | 2211 |
| setor | text | Código do setor (numérico ou texto)? | 2 |
| secao | text | Identificação da seção (opcional)? | PL2 |
| bloco | text | Identificação do bloco dentro do setor? | 5 |
| pivo | text | Identificação do pivô ou sistema de irrigação (opcional)? | P23 |
| talhao | text | Código do talhão (número identificador)? | 17 |
| area_gis | float | Área do talhão em hectares (calculada via GIS)? | 5.5488754 |
| tp_prop | text | Tipo de contrato/propriedade do talhão? | PROPRIAS |
| geometria | json (GeoJSON) | Geometria do talhão em formato GeoJSON – CRS EPSG:4326 (WGS 84)? | { "type": "Polygon", "coordinates": [ [ [ -48.123456, -21.987654 ], [ -48.123000, -21.987000 ], ... ] ] } |
Detalhamento dos Campos
chave
Chave única composta por: client_id_fazenda_setor_secao_bloco_pivo_talhao. Campos ausentes devem ser substituídos por 0 ou "0".
client_id
Código interno do cliente na plataforma SIGMA.
fazenda
Código ou número da fazenda.
setor
Identificador do setor dentro da fazenda.
secao
Identificador da seção (subdivisão do setor) como: SECAO 2, SECAO A.
bloco
Identificador do bloco.
pivo
Código do pivô central de irrigação.
talhao
Número do talhão monitorado.
area_gis
Área real do talhão em hectares, calculada a partir da geometria (GIS). Valor com até 6 casas decimais.
tp_prop
Identificação do tipo de contrato. Valores permitidos: PROPRIAS, PARCERIAS, ACIONISTAS, SPOT, ARRENDAMENTO, FORNECEDORES.
geometria
Geometria do talhão no formato GeoJSON (Polygon ou MultiPolygon).
- Sistema de coordenadas obrigatório: EPSG:4326 (WGS 84)
- Unidade: Graus decimais (latitude/longitude)
- Ordem das coordenadas: [longitude, latitude]
- Precisão recomendada: 6 casas decimais
- Anel externo: sentido horário (padrão GeoJSON)
Exemplo válido (Polygon simples):
{
"type": "Polygon",
"coordinates": [
[
[-48.123456, -21.987654],
[-48.123000, -21.987654],
[-48.123000, -21.988000],
[-48.123456, -21.988000],
[-48.123456, -21.987654]
]
]
}
Lagarta Fora (Broca) / LF – Monitoramento de Broca-da-Cana
Dados de monitoramento da lagarta fora (Diatraea saccharalis) em talhões de cana-de-açúcar. A consulta deve ser disponibilizada em formato *.json e conter os atributos elencados a seguir.
| Coluna | Tipo | Descrição | Exemplo |
|---|---|---|---|
| chave | text | Chave única do talhão? | 2025_7_2211_2_PL2_5_P23_17 |
| safra | int | Ano safra de referência? | 2025 |
| client_id | int | ID do cliente (fornecido pela SIGMA)? | 7 |
| unidade | text | Nome da usina/unidade? | USINA EXEMPLO |
| fazenda | text | Identificador da fazenda? | 2211 |
| setor | text | Identificador do setor? | 2 |
| secao | text | Identificador da seção? | PL2 |
| bloco | text | Identificador do bloco? | 5 |
| pivo | text | Identificador do pivô? | P23 |
| talhao | text | Identificador do talhão? | 17 |
| restricao_voo | int | Restrição de voo (0 = sem restrição, 1 = com restrição)? | 0 |
| lf_data_levantamento | timestamp | Data do levantamento (DD/MM/AAAA)? | 06/04/2025 |
| lf_area_levantada | float | Área efetivamente levantada (ha)? | 22.19 |
| lf_area_representada | float | Área representada pelo levantamento (ha)? | 40.48 |
| lf_area_monitorada | float | Área total monitorada (ha)? | 62.67 |
| lf_aderencia | text | Aderência ao cronograma? | COM AGENDA |
| lf_canas_avaliadas | int | Total de canas avaliadas? | 125 |
| lf_numero_canas_com_lf | int | Cana com presença de lagarta fora? | 0 |
| lf_porcentagem | float | Percentual de infestação? | 0.0 |
| lf_suscetibilidade | text | Classe de suscetibilidade da variedade? | RESISTENTE |
Detalhamento dos Campos
chave
Chave única composta por: safra_client_id_fazenda_setor_secao_bloco_pivo_talhao
safra
Ano da safra agrícola
client_id
Código interno do cliente na SIGMA
unidade
Nome da usina ou unidade produtiva
fazenda / setor / secao / bloco / pivo / talhao
Hierarquia geográfica completa do talhão como: SECAO 2, SECAO A
restricao_voo
0 = sem restrição de aplicação aérea | 1 = com restrição (ex: perto de cidades, rios, etc)
lf_data_levantamento
Data real do monitoramento no campo (formato DD/MM/AAAA)
lf_area_levantada
Área de levantamento em hectares
lf_area_representada
Área representada em hectares
lf_area_monitorada
Área monitorada em hectares
lf_aderencia
Aderência a operação em "COM AGENDA" ou "SEM AGENDA"lf_canas_avaliadas
Número de canas avaliadas
lf_numero_canas_com_lf
Número de canas com lagartas foras
lf_porcentagem
(lf_numero_canas_com_lf / lf_canas_avaliadas) × 100
lf_suscetibilidade
RESISTENTE, MODERADAMENTE RESISTENTE, INTERMEDIARIA, MODERADAMENTE SUSCETIVEL, ALTAMENTE SUSCETIVEL
Broca (Diatraea saccharalis)
Dados completos de monitoramento da broca-da-cana: armadilhas feromonais, esforço de campo (HH), parasitação natural e percentual de dano nos internódios.
| Coluna | Tipo | Descrição | Exemplo |
|---|---|---|---|
| chave | text | Chave única do talhão? | 2025_7_2211_2_PL2_5_P23_17 |
| safra | int | Ano safra de referência? | 2025 |
| client_id | int | ID do cliente (fornecido pela SIGMA)? | 7 |
| unidade | text | Nome da usina/unidade? | USINA EXEMPLO |
| fazenda | text | Número da fazenda? | 2211 |
| setor | text | Identificador do setor? | 2 |
| secao | text | Identificador da seção? | PL2 |
| bloco | text | Identificador do bloco? | 5 |
| pivo | text | Número do pivô? | P23 |
| talhao | text | Número do talhão? | 17 |
| restricao_voo | int | Restrição de voo (0 = sem, 1 = com)? | 0 |
| b_data_levantamento | timestamp | Data do levantamento? | 12/03/2022 |
| b_machos | int | Número de machos capturados na armadilha feromonal? | 190 |
| b_area_levantada | float | Área efetivamente levantada (ha)? | 61.95 |
| b_area_representada | float | Área representada pelo ponto (ha)? | 0 |
| b_area_monitorada | float | Área total monitorada no talhão (ha)? | 61.95 |
| b_aderencia | text | Aderência ao cronograma? | COM AGENDA |
| b_suscetibilidade | text | Classe de suscetibilidade da variedade? | ALTAMENTE SUSCETIVEL |
| b_hh | float | Total de horas-homem no levantamento? | 0 |
| b_hh_hora_monitorada_com_agenda | float | HH realizadas dentro do cronograma? | 0 |
| b_hh_hora_monitorada_sem_agenda | float | HH realizadas fora do cronograma? | 12.6775 |
| b_hh_representatividade | float | Percentual de representatividade do esforço? | 0 |
| b_dp_cotesia | int | Larvas parasitadas por Cotesia flavipes? | 0 |
| b_dp_crisalia | int | Larvas parasitadas por Lixophaga diatraeae (Crisália)? | 0 |
| b_dp_beauveria | int | Larvas infectadas por Beauveria bassiana? | 0 |
| b_dp_parasitada | int | Total de larvas parasitadas? | 0 |
| b_dp_danificadas | int | Total de internódios danificados? | 0 |
| b_dp_pequena | int | Broca em estágio pequeno? | 0 |
| b_dp_grande_media | int | Broca em estágio grande/média? | 0 |
| b_dp | float | Densidade populacional da broca? | 111.1111 |
Detalhamento dos Campos
chave
Chave única composta: safra_client_id_fazenda_setor_secao_bloco_pivo_talhao
safra
Ano da safra de referência
client_id
Código interno do cliente na SIGMA
unidade
Nome completo da usina/unidade
fazenda
Código da fazenda
setor
Identificador do setor
secao
Identificador da seção
bloco
Identificador do bloco
pivo
Código do pivô central
talhao
Número do talhão
restricao_voo
0 = sem restrição de aplicação aérea | 1 = com restrição
b_data_levantamento
Data do monitoramento no campo (DD/MM/AAAA)
b_machos
Total de adultos machos capturados na armadilha feromonal na semana
b_area_levantada
Área efetivamente percorrida no levantamento (ha)
b_area_representada
Área que cada ponto representa (ha)
b_area_monitorada
Área total monitorada no talhão (ha)
b_aderencia
COM AGENDA = dentro do cronograma | SEM AGENDA = fora
b_suscetibilidade
Suscetibilidade: RESISTENTE, ALTAMENTE SUSCETIVEL
b_hh
Total de horas-homem gastas no levantamento
b_hh_hora_monitorada_com_agenda
Horas-homem realizadas dentro do cronograma previsto
b_hh_hora_monitorada_sem_agenda
Horas-homem realizadas fora do cronograma
b_hh_representatividade
Percentual de representatividade do esforço de monitoramento
b_dp_cotesia
Densidade populacional de Larvas parasitadas por Cotesia flavipes
b_dp_crisalia
Densidade populacional de Larvas parasitadas por Lixophaga diatraeae (Crisália)
b_dp_beauveria
Densidade populacional de Larvas infectadas pelo fungo Beauveria bassiana
b_dp_parasitada
Densidade populacional de larvas parasitadas por qualquer agente biológico
b_dp_danificadas
Total de internódios danificados pela broca
b_dp_pequena
Quantidade de broca em estágio larval pequeno
b_dp_grande_media
Quantidade de broca em estágio larval grande ou média
b_dp
Densidade populacional total = (internódios danificados / total avaliados) × 100
Cigarrinha (Mahanarva fimbriolata)
Dados completos de monitoramento da cigarrinha-da-cana: área levantada, aderência ao cronograma, suscetibilidade da variedade, adultos capturados, densidade de ninfas e presença de espuma.
| Coluna | Tipo | Descrição | Exemplo |
|---|---|---|---|
| chave | text | Chave única do talhão? | 2025_7_2211_2_PL2_5_P23_17 |
| safra | int | Ano safra de referência? | 2025 |
| client_id | int | ID do cliente (fornecido pela SIGMA)? | 7 |
| unidade | text | Nome da usina/unidade? | USINA EXEMPLO |
| fazenda | text | Número da fazenda? | 2211 |
| setor | text | Identificador do setor? | 2 |
| secao | text | Identificador da seção? | PL2 |
| bloco | text | Identificador do bloco? | 5 |
| pivo | text | Número do pivô? | P23 |
| talhao | text | Número do talhão? | 17 |
| restricao_voo | int | Restrição de voo (0 = sem restrição, 1 = com restrição)? | 0 |
| c_data_levantamento | timestamp | Data do levantamento no campo? | 15/09/2025 |
| c_area_levantada | float | Área efetivamente percorrida no levantamento (ha)? | 6.80 |
| c_area_representada | float | Área representada por cada ponto amostrado (ha)? | 3.52 |
| c_area_monitorada | float | Área total monitorada no talhão (ha)? | 26.36 |
| c_aderencia | text | Aderência ao cronograma de monitoramento? | COM AGENDA |
| c_suscetibilidade | text | Classe de suscetibilidade da variedade à cigarrinha? | INTERMEDIARIA |
| c_adultos | int | Número total de adultos capturados (varredura ou armadilha)? | 0 |
| c_ninfas_metro | float | Densidade média de ninfas por metro linear de cana? | 0.50 |
| c_espuma_metro | float | Densidade média de espuma por metro linear (indicador de ninfas)? | 0.0 |
Detalhamento dos Campos
chave
Chave única composta: safra_client_id_fazenda_setor_secao_bloco_pivo_talhao
safra
Ano da safra de referência
client_id
Código interno do cliente na SIGMA
unidade
Nome completo da usina/unidade produtiva
fazenda
Código da fazenda
setor
Identificador do setor
secao
Identificador da seção como: SECAO 2, SECAO A
bloco
Identificador do bloco como: BLOCO A, BLOCO B
pivo
Código do pivô central como: L2, L3, C1
talhao
Número do talhão
restricao_voo
0 = sem restrição de aplicação aérea | 1 = com restrição (ex: perto de rios, cidades, etc)
c_data_levantamento
Data real do monitoramento no campo (formato DD/MM/AAAA)
c_area_levantada
Área efetivamente percorrida durante o levantamento (em hectares)
c_area_representada
Área que cada ponto de amostragem representa (em hectares)
c_area_monitorada
Soma total da área monitorada no talhão (em hectares)
c_aderencia
Indica se o levantamento foi feito dentro do cronograma previsto: "COM AGENDA" ou "SEM AGENDA"
c_suscetibilidade
Classe de suscetibilidade da variedade à cigarrinha:
RESISTENTE, MODERADAMENTE RESISTENTE, INTERMEDIARIA, MODERADAMENTE SUSCETIVEL. ALTAMENTE SUSCETIVEL
c_adultos
Número total de adultos capturados por varredura ou armadilha no talhão
c_ninfas_metro
Densidade média de ninfas por metro linear de linha de cana (principal indicador de infestação)
c_espuma_metro
Densidade média de espuma por metro linear — indicador indireto da presença de ninfas
Pragas de Solo – Levantamento Subterrâneo
Dados completos de monitoramento de pragas subterrâneas em talhões de cana-de-açúcar, incluindo cupins, bicudo-da-cana, broca-da-raiz, formigas saúva e outras pragas relevantes.
| Coluna | Tipo | Descrição | Exemplo |
|---|---|---|---|
| chave | text | Chave única do talhão? | 2025_7_2211_2_PL2_5_P23_17 |
| safra | int | Ano safra de referência? | 2025 |
| client_id | int | ID do cliente (fornecido pela SIGMA)? | 7 |
| unidade | text | Nome da usina/unidade? | USINA EXEMPLO |
| fazenda | text | Número da fazenda? | 2211 |
| setor | text | Identificador do setor? | 2 |
| secao | text | Identificador da seção? | PL2 |
| bloco | text | Identificador do bloco? | 5 |
| pivo | text | Número do pivô? | P23 |
| talhao | text | Número do talhão? | 17 |
| data | timestamp | Data do levantamento no campo? | 15/09/2025 |
| n_ponto | int | Número sequencial do ponto de amostragem? | 1 |
| cup_gen | text | Gênero do cupim? | COPTOTERMES |
| cup_danos_touceiras | text | Danos por cupins nas touceiras (S = sim, N = não)? | S |
| cup_nota_populacional | int | Nota populacional de cupins (0 a 5)? | 3 |
| sph_rizomas_totais | int | Total de rizomas coletados? | 700 |
| sph_rizomas_atacados | int | Rizomas atacados por Sphenophorus levis? | 13 |
| sph_larvas | int | Larvas de Sphenophorus levis? | 1 |
| sph_pupas | int | Pupas de Sphenophorus levis? | 0 |
| sph_adultos | int | Adultos de Sphenophorus levis? | 3 |
| mig_larvas | int | Larvas de Migdolus fryanus (broca-da-raiz)? | 0 |
| qnt_pao_galinha | int | Larva pão-de-galinha? | 12 |
| qnt_larva_arame | int | Larvas de besouro-arame (corós)? | 22 |
| qnt_naupactus | int | Gorgulhos do gênero Naupactus spp.? | 30 |
| qnt_eucalyptera | int | Pragas do gênero Eucalyptera spp.? | 4 |
| qnt_perola_terra | int | Pérola-da-terra (Eurhizococcus brasiliensis)? | 8 |
| qnt_percevejo_castanho | int | Percevejo-castanho-do-solo? | 10 |
| qnt_hiponeuma | int | Pragas do gênero Hiponeuma spp.? | 10 |
Detalhamento dos Campos
chave
Chave única composta por: safra_client_id_fazenda_setor_secao_bloco_pivo_talhao. Campos ausentes devem ser substituídos por 0 ou "0".
safra
Ano da safra agrícola de referência.
client_id
Código interno do cliente na plataforma SIGMA.
unidade
Nome completo da usina ou unidade produtiva.
fazenda
Código ou número da fazenda.
setor
Identificador do setor dentro da fazenda.
secao
Identificador da seção (subdivisão do setor) como: SECAO 2, SECAO A.
bloco
Identificador do bloco.
pivo
Código do pivô central de irrigação.
talhao
Número do talhão monitorado.
data
Data em que foi realizado o levantamento subterrâneo (DD/MM/AAAA).
n_ponto
Número sequencial do ponto de amostragem dentro do talhão.
cup_gen
Indica o gênero do cupim.
cup_danos_touceiras
Indica se há danos visíveis por cupins nas touceiras (S = sim, N = não).
cup_nota_populacional
Nota de 0 a 5 que representa a intensidade populacional de cupins (0 = ausente, 5 = altíssima).
sph_rizomas_totais
Quantidade total de rizomas coletados na amostra.
sph_rizomas_atacados
Quantidade de rizomas com ataque do bicudo-da-cana (Sphenophorus levis).
sph_larvas
Número de larvas de Sphenophorus levis encontradas.
sph_pupas
Número de pupas de Sphenophorus levis encontradas.
sph_adultos
Número de adultos de Sphenophorus levis encontrados.
mig_larvas
Larvas da broca-da-raiz (Migdolus fryanus).
qnt_pao_galinha
Quantidade de larvas pão-de-galinha.
qnt_larva_arame
Larvas de besouro-arame (corós) encontradas na amostra.
qnt_naupactus
Quantidade de gorgulhos do gênero Naupactus spp.
qnt_eucalyptera
Quantidade de insetos do gênero Eucalyptera spp.
qnt_perola_terra
Quantidade de pérola-da-terra (Eurhizococcus brasiliensis).
qnt_percevejo_castanho
Quantidade de percevejo-castanho-do-solo.
qnt_hiponeuma
Quantidade de insetos do gênero Hiponeuma spp.
Autenticação e Endpoints da API
A fim de garantir a integridade e segurança da informação, será gerado um token de acesso (chave de API) único, individual e intransferível. Em caso de suspeita de vazamento, o token será revogado imediatamente e um novo será emitido.
Importante: Nunca compartilhe seu token. Ele é pessoal e intransferível.
Como usar o token (Header)
Inclua o token em todas as requisições no cabeçalho HTTP:
| Header | Valor |
|---|---|
Authorization | Bearer edc40e3b-4002-4590-9bba-847200a80e84 |
Exemplo completo com cURL:
curl -X GET "https://integracaotomo.sigmageotecnologias.com.br/api/historico-safra?usina=usina-exemplo" \
-H "Authorization: Bearer edc40e3b-4002-4590-9bba-847200a80e84"
Endpoints Disponíveis
Todos os endpoints utilizam o mesmo padrão de autenticação e retornam JSON.
| Recurso | Método | Endpoint | Descrição |
|---|---|---|---|
| Dados Gerais | GET | /api/historico-safra?usina={usina} |
Retorna o histórico completo de safras e talhões |
| Dados Gerais | POST | /api/historico-safra?usina={usina} |
Envia/atualiza dados gerais da safra |
| Chuvas | GET | /api/precipitacao?usina={usina} |
Retorna dados diários de precipitação e temperatura |
| Chuvas | POST | /api/precipitacao?usina={usina} |
Envia novos registros meteorológicos |
| Talhões (geometrias) | GET | /api/base-talhoes?usina={usina} |
Retorna todos os talhões com geometria GeoJSON (EPSG:4326) |
| Talhões (geometrias) | POST | /api/base-talhoes?usina={usina} |
Envia/atualiza base de talhões georreferenciados |
| Lagarta Fora (Broca) | GET | /api/lagarta-fora?usina={usina} |
Retorna todos os dados da lagarta fora |
| Lagarta Fora (Broca) | POST | /api/lagarta-fora?usina={usina} |
Envia/atualiza a base de dados de lagarta fora |
| Broca | GET | /api/broca?usina={usina} |
Retorna todos os dados da broca |
| Broca | POST | /api/broca?usina={usina} |
Envia/atualiza a base de dados da broca |
| Cigarrinha | GET | /api/cigarrinha?usina={usina} |
Retorna todos os dados da cigarrinha |
| Cigarrinha | POST | /api/cigarrinha?usina={usina} |
Envia/atualiza a base de dados da cigarrinha |
| Pragas de Solo | GET | /api/pragas-solo?usina={usina} |
Retorna todos os dados da praga de solo |
| Pragas de Solo | POST | /api/pragas-solo?usina={usina} |
Envia/atualiza a base de dados das pragas de solo |
Base URL (produção):
https://integracaotomo.sigmageotecnologias.com.br/api/
Dica: Substitua {usina} pelo código/nome da sua usina (ex: usina-exemplo, usina-abc, etc).
Esse parâmetro é obrigatório em todas as chamadas.
Perguntas Frequentes – API Tomografia do Canavial
Informações técnicas oficiais sobre a integração com o sistema Tomografia do Canavial da Sigma Digital Geotecnologias no Agro.
Sigma Digital Geotecnologias no Agro
https://integracaotomo.sigmageotecnologias.com.br
10.17.30.11
Porta 443 – HTTPS
JSON
RESTful
TLS 1.2
Autenticação via chave de API
RBAC – Role-Based Access Control
Sim – implementa proteções contra SQL Injection, XSS, CSRF, rate limiting e ataques de força bruta.
Contatos – Suporte Técnico e Comercial
Em caso de dúvidas sobre a integração, documentação, testes ou qualquer necessidade técnica/comercial, entre em contato diretamente com a equipe responsável da Sigma Digital Geotecnologias no Agro.
Justino Neto
Gerente de Projetos e Integrações
E-mail: justino.neto@sigmagis.com.br
Telefone / WhatsApp: (16) 99962-5930
Victoria Vagner
Coordenadora de Geoprocessamento
E-mail: victoria.vagner@sigmagis.com.br
Telefone / WhatsApp: (16) 99609-8129
Dica: Preferencialmente inicie o contato via WhatsApp ou e-mail. Assim conseguimos registrar o atendimento e dar sequência com mais agilidade.