Contexto Geral

A presente API destina-se para a consulta de Acerto Anual e Final de Safra, permitindo obter informações consolidadas sobre ajustes financeiros e/ou contratuais relacionados ao ciclo da safra, garantindo transparência, rastreabilidade e apoio à gestão de contratos de matéria-prima.


Estrutura:

AtributoDescriçãoTamanhoTipoObservação
instanciaIdentificador da instância2NuméricoIdentifica a instância do processo
amAcertoMês/ano do acerto10DataEx: “2018-09-01T00:00:00”
fgTpProcTipo de processo2TextoEx: “9”
pcAcertoPercentual de acerto5,2NuméricoEx: 100
dtBaseAtrData base ATR10DataEx: “2018-09-30T00:00:00”
cdSafraCódigo da safra4NuméricoEx: 2018
vlAtrValor ATR (kg ATR)12,4NuméricoEx: 136.92
vlTonCanaValor por tonelada de cana12,2NuméricoEx: 74.78
qtCanaEntQuantidade de cana entregue12NuméricoEx: 33341816
vlCanaBrutoValor bruto da cana14,2NuméricoEx: 2610359.32
vlCanaLiqValor líquido da cana14,2NuméricoEx: 2610359.32
vlFatorkValor do fator K8,3NuméricoEx: 1
vlPg100Valor pago 100%12,2NuméricoPode ser nulo
vlAcertoAtrValor do acerto ATR12,2NuméricoPode ser nulo
vlTotServValor total de serviços12,2NuméricoPode ser nulo
fgAcertoFinalFlag de acerto final1Texto“S” ou “N”
fgIndividualFlag de cálculo individual1Texto“S” ou “N”
vlAcAtrRecebValor ATR recebido12,2NuméricoEx: 0
vlKgAtrValor por Kg ATR8,4NuméricoEx: 0.5718
vlTotBonusValor total de bônus12,2NuméricoPode ser nulo
vlRecPgTotValor total recebido/pago12,2NuméricoPode ser nulo
fatorReducaoFator de redução aplicado8,3NuméricoPode ser nulo
acTotNfAcúmulo total de notas fiscais12,2NuméricoPode ser nulo
vlTotServCorrValor total de serviços corrigido12,2NuméricoPode ser nulo
fgCalcAcertoTipo de cálculo de acerto1TextoEx: “A”
fgAcertoAnualFlag de acerto anual1Texto“S” ou “N”
fgContrRescindFlag contrato rescindido1TextoPode ser nulo
instContrInstância do contrato2NuméricoEx: “1”
cdEmpContrCódigo da empresa do contrato3NuméricoEx: “1”
noContrCanaNúmero do contrato de cana6NuméricoEx: 2552
vlRefAnoValor referência anual12,2NuméricoPode ser nulo
vlIcmsValor ICMS12,2NuméricoEx: 0
vlDescGeocanaValor desconto Geocana12,2NuméricoPode ser nulo
qtAtrSemPremioQuantidade ATR sem prêmio12,2NuméricoPode ser nulo

infoUpnivel1.cdUpnivel1Código unidade nível 110TextoEx: “10002”
infoUpnivel1.deUpnivel1Descrição unidade nível 150TextoEx: “FAZENDA TOTVS 10002”
infoUpnivel1.cdFornecCódigo do fornecedor6NuméricoEx: 319
infoUpnivel1.fgTpPessTipo de pessoa1Texto“J” (Jurídica)
infoUpnivel1.cdIntErpCódigo de integração ERP20TextoEx: “1_600_2”

infoFornecs.cdFornecCódigo do fornecedor6NuméricoEx: 319
infoFornecs.deFornecNome do fornecedor50TextoEx: “FORNECEDOR TOTVS 2”
infoFornecs.fgTpFornecTipo do fornecedor1TextoEx: “4”
infoFornecs.deTpFornecDescrição tipo fornecedor30Texto

1 - ACIONISTA

2 - FORNECEDOR

3 - EVENTUAL

4 - PROPRIO

5 - PARCEIRO

infoFornecs.fgTpPessTipo de pessoa1Texto“J”
infoFornecs.cdIntErpCódigo de integração ERP20TextoEx: “319”

tipoPropriedade.cdTpProprCódigo do tipo de propriedade2NuméricoEx: 1
tipoPropriedade.deTpProprDescrição do tipo de propriedade30TextoEx: “PRÓPRIA”

tipoCalculo.cdTpCalcCódigo do tipo de cálculo2NuméricoEx: 99
tipoCalculo.deTpCalcDescrição do tipo de cálculo20TextoEx: “CONSECANA”

unidadeIndustrial.cdUnidIndCódigo da unidade industrial3NuméricoEx: 1
unidadeIndustrial.deUnidIndDescrição da unidade industrial50TextoEx: “USINA TOTVS 01”


Método GET:

http:127.0.0.1:8080/api/query/v1/acertoAnualFinalSafra

{
   "hasNext":true,
   "items":[
      {
         "instancia":"1",
         "amAcerto":"2018-09-01T00:00:00",
         "fgTpProc":"9",
         "pcAcerto":100,
         "dtBaseAtr":"2018-09-30T00:00:00",
         "cdSafra":2018,
         "vlAtr":136.92,
         "vlTonCana":74.78,
         "qtCanaEnt":33341816,
         "vlCanaBruto":2610359.32,
         "vlCanaLiq":2610359.32,
         "vlFatork":1,
         "vlPg100":null,
         "vlAcertoAtr":null,
         "vlTotServ":null,
         "fgAcertoFinal":"N",
         "fgIndividual":"N",
         "vlAcAtrReceb":0,
         "vlKgAtr":0.5718,
         "vlTotBonus":null,
         "vlRecPgTot":null,
         "fatorReducao":null,
         "acTotNf":null,
         "vlTotServCorr":null,
         "fgCalcAcerto":"A",
         "fgAcertoAnual":"N",
         "fgContrRescind":null,
         "instContr":"1",
         "cdEmpContr":"1",
         "noContrCana":2552,
         "vlRefAno":null,
         "vlIcms":0,
         "vlDescGeocana":null,
         "qtAtrSemPremio":null,
         "infoUpnivel1":[
            {
               "cdUpnivel1":" 10002",
               "deUpnivel1":"FAZENDA TOTVS  10002",
               "cdFornec":319,
               "fgTpPess":"J",
               "cdIntErp":"1_600_2"
            }
         ],
         "infoFornecs":[
            {
               "cdFornec":319,
               "deFornec":"FORNECEDOR TOTVS 2",
               "fgTpFornec":"4",
               "deTpFornec":"PROPRIO",
               "fgTpPess":"J",
               "cdIntErp":"319"
            }
         ],
         "tipoPropriedade":[
            {
               "cdTpPropr":1,
               "deTpPropr":"PROPRIA"
            }
         ],
         "tipoCalculo":[
            {
               "cdTpCalc":99,
               "deTpCalc":"CONSECANA"
            }
         ],
         "unidadeIndustrial":[
            {
               "cdUnidInd":1,
               "deUnidInd":"USINA TOTVS 01"
            }
         ]
      }
   ]
}


Parâmetros Obrigatórios


Parâmetros Opcionais