Contexto Geral
A presente API destina-se para a consulta de Acerto de Provisão Anual e Final, permitindo acessar dados consolidados sobre ajustes de provisões realizadas ao longo do período e seu fechamento, assegurando transparência, rastreabilidade.
Estrutura:
| Atributo | Descrição | Tipo | Observação |
|---|---|---|---|
| instancia | Identificador da instância | Numérico | Indica o contexto do processamento |
| tpRegistro | Tipo de registro | Texto | P - Provisão N -NF c/ Acerto F - Folha c/ Acerto N - Mensal |
| amAcerto | Mês/ano do acerto | Data | Ex: “2016-04-01T00:00:00” |
| pcAcerto | Percentual de acerto | Numérico | Ex: 100 |
| dtBaseAtr | Data base ATR | Data | Ex: “2016-04-01T00:00:00” |
| cdSafra | Código da safra | Numérico | Ex: 2016 |
| vlAtr | Valor ATR (kg ATR) | Numérico | Ex: 131.6 |
| vlTonCana | Valor por tonelada de cana | Numérico | Ex: 77.394 |
| qtCanaEnt | Quantidade de cana entregue | Numérico | Ex: 898384 |
| vlCanaBruto | Valor bruto da cana | Numérico | Ex: 69529.53 |
| vlCanaLiq | Valor líquido da cana | Numérico | Ex: 69529.53 |
| vlFatork | Valor do fator K | Numérico | Ex: 1 |
| vlPg100 | Valor pago 100% | Numérico | Pode ser nulo |
| vlAcertoAtr | Valor do acerto ATR | Numérico | Pode ser nulo |
| vlTotServ | Valor total de serviços | Numérico | Ex: 0 |
| fgAcertoFinal | Flag de acerto final | Texto | “S” ou “N” |
| fgIndividual | Flag de cálculo individual | Texto | “S” ou “N” |
| vlAcAtrReceb | Valor ATR recebido | Numérico | Ex: 0 |
| vlKgAtr | Valor por Kg ATR | Numérico | Ex: 0.5881 |
| vlTotBonus | Valor total de bônus | Numérico | Ex: 0 |
| vlTotServCorr | Valor total de serviços corrigido | Numérico | Ex: 0 |
| fgAcertoAnual | Flag de acerto anual | Texto | “S” ou “N” |
| fgContrRescind | Flag de contrato rescindido | Texto | Pode ser nulo |
| instContr | Instância do contrato | Numérico | Ex: “1” |
| cdEmpContr | Código da empresa do contrato | Numérico | Ex: “1” |
| noContrCana | Número do contrato de cana | Numérico | Ex: 1159 |
| vlRefAno | Valor referência anual | Numérico | Pode ser nulo |
| fgProvMensal | Flag de provisão mensal | Texto | “S” ou “N” |
| fgTpProc | Tipo de processo | Texto | Ex: “9” |
| vlIcms | Valor ICMS | Numérico | Pode ser nulo |
| vlDescGeocana | Valor desconto Geocana | Numérico | Pode ser nulo |
| qtAtrSemPremio | Quantidade ATR sem prêmio | Numérico | Pode ser nulo |
| infoUpnivel1.cdUpnivel1 | Código unidade nível 1 | Texto | Ex: “10001” |
| infoUpnivel1.deUpnivel1 | Descrição unidade nível 1 | Texto | Ex: “FAZENDA TOTVS 10001” |
| infoUpnivel1.cdFornec | Código do fornecedor | Numérico | Ex: 319 |
| infoUpnivel1.fgTpPess | Tipo de pessoa | Texto | “J” (Jurídica) |
| infoUpnivel1.cdIntErp | Código integração ERP | Texto | Ex: “1_600_1” |
| infoFornecs.cdFornec | Código do fornecedor | Numérico | Ex: 319 |
| infoFornecs.deFornec | Nome do fornecedor | Texto | Ex: “FORNECEDOR TOTVS 2” |
| infoFornecs.fgTpFornec | Tipo do fornecedor | Texto | Ex: “4” |
| infoFornecs.deTpFornec | Descrição tipo fornecedor | Texto | 1 - ACIONISTA 2 - FORNECEDOR 3 - EVENTUAL 4 - PROPRIO 5 - PARCEIRO |
| infoFornecs.fgTpPess | Tipo de pessoa | Texto | “J” |
| infoFornecs.cdIntErp | Código de integração ERP | Texto | Ex: “319” |
| tipoPropriedade.cdTpPropr | Código do tipo de propriedade | Numérico | Ex: 2 |
| tipoPropriedade.deTpPropr | Descrição do tipo de propriedade | Texto | Ex: “PARCERIA/ARREND” |
| tipoCalculo.cdTpCalc | Código do tipo de cálculo | Numérico | Ex: 99 |
| tipoCalculo.deTpCalc | Descrição do tipo de cálculo | Texto | Ex: “CONSECANA” |
| unidadeIndustrial.cdUnidInd | Código da unidade industrial | Numérico | Ex: 1 |
| unidadeIndustrial.deUnidInd | Descrição da unidade industrial | Texto | Ex: “USINA TOTVS 01” |
Método GET:
http:127.0.0.1:8080/api/query/v1/acertoProv
Response
{
"hasNext":true,
"items":[
{
"instancia":"1",
"tpRegistro":"Provisão",
"amAcerto":"2016-04-01T00:00:00",
"pcAcerto":100,
"dtBaseAtr":"2016-04-01T00:00:00",
"cdSafra":2016,
"vlAtr":131.6,
"vlTonCana":77.394,
"qtCanaEnt":898384,
"vlCanaBruto":69529.53,
"vlCanaLiq":69529.53,
"vlFatork":1,
"vlPg100":null,
"vlAcertoAtr":null,
"vlTotServ":0,
"fgAcertoFinal":"N",
"fgIndividual":"N",
"vlAcAtrReceb":0,
"vlKgAtr":0.5881,
"vlTotBonus":0,
"vlTotServCorr":0,
"fgAcertoAnual":"N",
"fgContrRescind":null,
"instContr":"1",
"cdEmpContr":"1",
"noContrCana":1159,
"vlRefAno":null,
"fgProvMensal":"N",
"fgTpProc":"9",
"vlIcms":null,
"vlDescGeocana":null,
"qtAtrSemPremio":null,
"infoUpnivel1":[
{
"cdUpnivel1":" 10001",
"deUpnivel1":"FAZENDA TOTVS 10001",
"cdFornec":319,
"fgTpPess":"J",
"cdIntErp":"1_600_1"
}
],
"infoFornecs":[
{
"cdFornec":319,
"deFornec":"FORNECEDOR TOTVS 2",
"fgTpFornec":"4",
"deTpFornec":"PROPRIO",
"fgTpPess":"J",
"cdIntErp":"319"
}
],
"tipoPropriedade":[
{
"cdTpPropr":2,
"deTpPropr":"PARCERIA/ARREND"
}
],
"tipoCalculo":[
{
"cdTpCalc":99,
"deTpCalc":"CONSECANA"
}
],
"unidadeIndustrial":[
{
"cdUnidInd":1,
"deUnidInd":"USINA TOTVS 01"
}
]
}
]
}
Parâmetros Obrigatórios
- instancia: Código da Instância.
- amAcerto: Data de Acerto.
Parâmetros Opcionais
- cdUnidInd: Código da Unidade Industrial.
- cdUpnivel1: Código de Fazenda.
- tpRegistro: . Tipo de Registro
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas