Páginas filhas
  • API Recibo de Pagamento de Cana por Fornecedor

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Disponibilizado endpoint para consulta dos Recibos de Pagamento de Cana por Fornecedor.


EstruturaEstruturas:

AtributosDescrição
Tamanho
TipoObservação
instanciaIdentificador da instância
1
StringValor do tipo string numérica
fgTpFolhaTipo da folha
1tipoFolhaDescrição do tipo de folha50StringEx.: "FOLHA ANUAL DE FORNECEDOR"dataFornecimentoData de fornecimento-
String
Ex.: "A"
F - FOLHA MENSAL DE FORNECEDOR 
P - FOLHA MENSAL DE PARCERIA 
T - FOLHA MENSAL DE TERCEIROS 
A - FOLHA ANUAL DE FORNECEDOR 
B - FOLHA ANUAL DE PARCERIA 
G - FOLHA ANUAL DE TERCEIROS 
C - FOLHA FINAL DE FORNECEDOR 
D - FOLHA FINAL DE PARCERIA 
H - FOLHA FINAL DE TERCEIROS
tipoFolhaDescrição do tipo de folhaStringEx.: "FOLHA ANUAL DE FORNECEDOR"
dataFornecimentoData de fornecimento
DateTimeFormato ISO 8601: yyyy-MM-dd'T'HH:mm:ss
dataEmissaoData de emissão
-
DateTimeFormato ISO 8601
safraAno da safra
4
IntegerEx.: 2016
vlToneladaCanaValor da tonelada de cana
-
DecimalEx.: 79.5347918
qtCanaEntregueQuantidade de cana entregue
-
IntegerEx.: 242213106
vlBrutoReciboValor bruto do recibo
-
Decimal
vlAcumTaxasContribValor acumulado de taxas de contribuição
-
Decimal
vlAcumDeducoesValor acumulado de deduções
-
Decimal
vlAcumNFPromissoriasValor acumulado de notas promissórias
-
Decimal
vlLiquidoReciboValor líquido do recibo
-
Decimal
vlRetencaoValor de retenção
-
Decimal
cdTpPropriedadeCódigo do tipo de propriedade
-
Integer
fgProcIndividualFlag de processamento individual
1
String/NullablePode ser nulo
pcPagamentoPercentual de pagamento
-
Decimal/NullablePode ser nulo
cdUsuarioInclusaoUsuário que incluiu o registro
50
StringEx.: "TOTVS"
dtHrInclusaoData e hora de inclusão
-
DateTimeFormato ISO 8601
cdUsuarioAlteracaoUsuário que alterou o registro
50
String/NullablePode ser nulo
dtHtAlteracaoData e hora da última alteração
-
DateTime/NullablePode ser nulo
fgStatusIntegracaoFlag de status da integração
1
StringEx.: "1"
fluxoCaixaDescrição do fluxo de caixa
50
String
String

Parâmetro:

Ex.

Seção:

"

RCMP_PGTCP -

FLXCX - REC"

Entrada: CD_TP_FLXCX_REC_DS


Seção historicoTaxas

AtributosDescrição
Tamanho
TipoObservação
dtFimPeriodoData final do período
-
DateTime
safraAno da safra
4
Integer
fgLiminarSuspCobrancaICMSFlag liminar suspensão ICMS
1
String/NullablePode ser nulo
vlBaseTaxaValor base da taxa
-
Decimal
dtInicioPeriodoData inicial do período
-
DateTime
cdTaxaCódigo da taxa
-
Integer
detalheCdTaxaLista de detalhes da taxa
-
ArrayContém informações detalhadas da taxa
grupoTaxaContribuicaoGrupo da taxa de contribuição
-
Integer
fornecedorCódigo do fornecedor
-
Integer
upnivel1Código de hierarquia
10
String
vlTaxaContribuicaoValor da taxa de contribuição
-
Decimal
vlSubsidioValor do subsídio
-
Decimal


Seção detalheCdTaxa (dentro de historicoTaxas)

AtributosDescrição
Tamanho
TipoObservação
cdTaxaContribuicaoCódigo da taxa de contribuição
-
Integer
fgAcertoAnoFlag de acerto anual
1
StringEx.: "S"
codigoEspecieCódigo da espécie
20
String
percentualReducaoBasePercentual de redução da base
-
Decimal/NullablePode ser nulo
cdIndiceBaseCódigo do índice base
-
Integer
cdTxErpCódigo do ERP
-
Integer/NullablePode ser nulo
dtValidadeInicialData inicial de validade
-
DateTime
codigoClassificacaoCódigo de classificação
20
String
deTaxaContribuicaoDescrição da taxa de contribuição
50
String
percentualTaxaContribuicaoPercentual da taxa de contribuição
-
Decimal


Seção historicoDeducoes

AtributosDescrição
Tamanho
TipoObservação
cdGrupoEventoCódigo do grupo de evento
-
Integer
dtFimPeriodoData final do período
-
DateTime
cdEventoCódigo do evento
-
Integer
noCtaContbNumero da Conta ContábilInteger
vlDeducaoValor da dedução
-
Decimal
dtInicioPeriodoData inicial do período
-
DateTime
dtHtAlteracaoData da última alteração
-
DateTime
dtEventoData do evento
-
DateTime
cdUsuarioInclusaoUsuário que incluiu o registro
50
String
fgProcessaIndividualFlag de processamento individual
1
StringEx.: "S"
instanciaInstância do registro
1
String
dtHrInclusaoData e hora de inclusão
-
DateTime
cdUsuarioAlteracaoUsuário que alterou o registro
50
String
cdFornecedorCódigo do fornecedor
-
Integer

infoFornecs


fgDedAdiantFlag indicativa para dedução de Adiantamento String'S' ou 'N'


Seção infoFornecs

AtributosDescrição
AtributosDescriçãoTamanho
TipoObservação
cdFornecCódigo do fornecedor
-
Integer
deFornecDescrição do fornecedor
50
String
fgTpFornecTipo de fornecedorString

1

StringEx.: "4"

- ACIONISTA

2 - FORNECEDOR

3 - EVENTUAL

4 - PROPRIO

5 - PARCEIRO

deTpFornecDescrição do tipo de fornecedor
20
StringEx.: "PROPRIO"
fgTpPessTipo de pessoa
1
StringEx.: "J"
cdIntErpCódigo interno no ERP
-
String/Integer

Método GET:



Seção notasFiscais

AtributosDescriçãoTipoObservação
cdSerieNfCódigo da série NFString
noNfNúmero da Nota FiscalInteger



Método GET:

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

...

Bloco de código
languagejava
titleRecibo de Pagamento de Cana por Fornecedor
{
   "hasNext":true,
   "items":[
      {      {
         "instancia":"1",
         "fgTpFolha":"A",
         "tipoFolha":"FOLHA ANUAL DE FORNECEDOR",
         "dataFornecimento":"2016-05-01T00:00:00",
         "dataEmissao":"2016-05-01T00:00:00",
         "safra":2016,
         "vlToneladaCana":79.5347918,
         "qtCanaEntregue":242213106,
         "vlBrutoRecibo":19264368.96,
         "vlAcumTaxasContrib":0,
         "vlAcumDeducoes":0,
         "vlAcumNFPromissorias":0,
         "vlLiquidoRecibo":19264368.96,
         "vlRetencao":0,
         "cdTpPropriedade":1,
         "fgProcIndividual":null,
         "pcPagamento":null,
         "instanciacdUsuarioInclusao":"1TOTVS",
         "fgTpFolhadtHrInclusao":"A2025-04-16T13:28:59",
         "tipoFolhacdUsuarioAlteracao":"FOLHA ANUAL DE FORNECEDOR"null,
         "dtHtAlteracao":null,
         "dataFornecimentofgStatusIntegracao":"2016-05-01T00:00:001",
         "dataEmissaofluxoCaixa":"2016-05-01T00:00:00RCMP - FLXCX - REC",
         "safrahistoricoTaxas":2016,[
         "vlToneladaCana":79.5347918,
   {
      "qtCanaEntregue":242213106,
         "vlBrutoRecibodtFimPeriodo":19264368.96,
"2016-05-31T00:00:00",
               "vlAcumTaxasContribsafra":02016,
         "vlAcumDeducoes":0,
         "vlAcumNFPromissoriasfgLiminarSuspCobrancaICMS":0null,
         "vlLiquidoRecibo":19264368.96,
         "vlRetencaovlBaseTaxa":0944.86,
         "cdTpPropriedade":1,
         "dtInicioPeriodo"fgProcIndividual":null,
   :"2016-05-01T00:00:00",
      "pcPagamento":null,
         "cdUsuarioInclusaodtHtAlteracao":"TOTVS",
null,
               "dtHrInclusaocdTaxa":"2025-04-16T13:28:59"1,
               "cdUsuarioAlteracaocdUsuarioInclusao":null,
         "dtHtAlteracao":null,
         "fgStatusIntegracaoinstancia":"1",
               "fluxoCaixadtHrInclusao":"RCMP - FLXCX - REC",
null,
               "historicoTaxasdetalheCdTaxa":[
            {
        {
       "dtFimPeriodo":"2016-05-31T00:00:00",
               "safracdTaxaContribuicao":20161,
               "fgLiminarSuspCobrancaICMS":null,
         "fgAcertoAno":"S",
      "vlBaseTaxa":944.86,
               "dtInicioPeriodo":"2016-05-01T00:00:00codigoEspecie":"ESPECIE 1",
               "dtHtAlteracao      "percentualReducaoBase":null,
                     "cdTaxacdIndiceBase":1950,
                     "cdUsuarioInclusaocdTxErp":null,
                     "instanciadtValidadeInicial":"12015-10-01T00:00:00",
               "dtHrInclusao":null,
               "detalheCdTaxacodigoClassificacao":["CLAS 1",
                  {   "deTaxaContribuicao":"INSS",
                     "cdTaxaContribuicaopercentualTaxaContribuicao":1,
.3
                  }
        "fgAcertoAno":"S",
       ],
               "codigoEspeciegrupoTaxaContribuicao":"ESPECIE 1",
                     "percentualReducaoBasefgAcertoAnual":null,
                     "cdIndiceBasefornecedor":950319,
               "upnivel1":" 10094",
       "cdTxErp":null,
        "vlTaxaContribuicao":19.84,
               "dtValidadeInicialvlSubsidio":"2015-10-01T00:00:00"0,
               "cdUsuarioAlteracao":null
           "codigoClassificacao":"CLAS 1" },
            {
         "deTaxaContribuicao      "dtFimPeriodo":"INSS2016-05-31T00:00:00",
                     "percentualTaxaContribuicaosafra":1.32016,
                  }"fgLiminarSuspCobrancaICMS":null,
               ]"vlBaseTaxa":944.86,
                "grupoTaxaContribuicao":1"dtInicioPeriodo":"2016-05-01T00:00:00",
               "fgAcertoAnualdtHtAlteracao":null,
               "fornecedorcdTaxa":3192,
               "upnivel1cdUsuarioInclusao":" 10094"null,
               "vlTaxaContribuicaoinstancia":19.84"1",
               "vlSubsidiodtHrInclusao":0null,
               "cdUsuarioAlteracaodetalheCdTaxa":null[
            },
      {
      {
               "dtFimPeriodocdTaxaContribuicao":"2016-05-31T00:00:00"2,
                     "safrafgAcertoAno":2016"S",
                     "fgLiminarSuspCobrancaICMScodigoEspecie":null"ESPECIE 2",
                     "vlBaseTaxapercentualReducaoBase":944.86null,
               "dtInicioPeriodo":"2016-05-01T00:00:00",
          "cdIndiceBase":950,
     "dtHtAlteracao":null,
                "cdTaxacdTxErp":2null,
                     "cdUsuarioInclusaodtValidadeInicial":null"2015-10-01T00:00:00",
                     "instanciacodigoClassificacao":"1CLAS 2",
                     "dtHrInclusaodeTaxaContribuicao":null"SENAR",
               "detalheCdTaxa":[
      "percentualTaxaContribuicao":0.2
            {
      }
               "cdTaxaContribuicao":2],
                     "fgAcertoAnogrupoTaxaContribuicao":"S"1,
                     "codigoEspeciefgAcertoAnual":"ESPECIE 2"null,
                     "percentualReducaoBasefornecedor":null319,
                     "cdIndiceBaseupnivel1":950,
     " 10094",
                "cdTxErpvlTaxaContribuicao":null1.87,
                     "dtValidadeInicial":"2015-10-01T00:00:00""vlSubsidio":0,
               "cdUsuarioAlteracao":null
        "codigoClassificacao":"CLAS 2",
   }
         ],
         "deTaxaContribuicaohistoricoDeducoes":"SENAR",
[
            {
               "percentualTaxaContribuicaocdGrupoEvento":0.2,
                  }"dtFimPeriodo":"2016-05-31T00:00:00",
               ]"cdEvento":162,
               "grupoTaxaContribuicaonoCtaContb":1162,
               "fgAcertoAnualvlDeducao":null150,
               "dtInicioPeriodo"fornecedor":319:"2016-05-01T00:00:00",
               "upnivel1":" 10094""dtHtAlteracao":"2024-08-07T21:00:00",
               "vlTaxaContribuicao":1.87dtEvento":"2016-04-01T00:00:00",
               "vlSubsidiocdUsuarioInclusao":0"TOTVS",
               "cdUsuarioAlteracaofgProcessaIndividual":null"S",
            }
   "instancia":"1",
      ],
         "dtHrInclusao"historicoDeducoes":[:"2024-08-06T03:00:00",
            {   "cdUsuarioAlteracao":"TOTVS",
               "cdGrupoEventocdFornecedor":2319,
               "dtFimPeriodofgDedAdiant":"2016-05-31T00:00:00",S"
            }
   "cdEvento":162,
      ],
         "vlDeducaoinfoFornecs":150,
        [
       "dtInicioPeriodo":"2016-05-01T00:00:00",     {
               "dtHtAlteracaocdFornec":"2024-08-07T21:00:00"319,
               "dtEventodeFornec":"2016-04-01T00:00:00FORNECEDOR TOTVS 2",
               "cdUsuarioInclusaofgTpFornec":"TOTVS4",
               "fgProcessaIndividualdeTpFornec":"SPROPRIO",
               "instanciafgTpPess":"1J",
               "dtHrInclusao":"2024-08-06T03:00:00","cdIntErp":"319"
            }
   "cdUsuarioAlteracao":"TOTVS",
      ],
         "cdFornecedornotasFiscais":319[
            }{
             ]  "cdSerieNf":"8",
               "infoFornecsnoNf":[363
            {},
               "cdFornec":319,{
               "deForneccdSerieNf":"FORNECEDOR TOTVS 28",
               "fgTpFornecnoNf":"4",364
            },
            "deTpFornec":"PROPRIO",{
               "fgTpPesscdSerieNf":"J8",
               "cdIntErpnoNf":"319"365
            }
         ]
      }
   ]
}


Parâmetros Obrigatórios

...

  • fgTpProc: Flag Controlador de Tipo de Processo.
  • cdFornecedor: Código do Fornecedor.
  • dataFornecimento: Data de Fornecimento (atributo AM_FORNEC).
  • fgStatusIntegracao; Status da Integração ( ex: S;N;P ou nulo)

Atualizar status de integração - Recibos de Pagamento de Cana por Fornecedor

...

Método PUT:

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

...