Árvore de páginas

Tempo aproximado para leitura: 00 min

API para Inclusão de Redução Z do Varejo


01. DADOS GERAIS

Linha de Produto:

Protheus

Segmento:

Varejo

Módulo:

SIGALOJA

Função:

RetailreductionObj - Classe para tratamento da API de Redução Z do Varejo

RetailReductionApi - API para Inclusão de Redução Z do Varejo

02. SITUAÇÃO/REQUISITO

Existia a necessidade de efetuar Inclusão de Redução Z sem acessar o Protheus e sem realizar todas as validações pertinentes ao módulo Sigaloja.

Onde  as Informações deveriam ser Incluídas para posterior validação por rotina especifica de integração.

03. SOLUÇÃO

Para possibilitar as Inclusão de Redução Z, foi realizado a criação de uma API em serviço REST, onde serão armazenados dados da tabela SFI.

Antes dos registros serem processados poderá ser executado a rotina de pré-validação para deixar os registros aptos.

Para mais detalhes sobre a rotina de pré-validação acesse: DVARLOJ1-3871 DT - Job de Processamento RMI.

04. DEMAIS INFORMAÇÕES

Atenção:
Está API é de uso interno do Protheus para Integrações.


Neste serviço serão disponibilizados os verbos:

  • POST - "/api/retail/v1/RetailReduction/"
    Inclui uma Redução Z e Retorna uma lista com o detalhes.


Exemplo Json:

{
"BranchId" : "D MG 01" ,
"MovementDate" : "2019-08-26T13:17:21",
"Id" : "001" ,
"PosNumber" : "123" ,
"PosSerieNumber" : "999" ,
"ReductionCode" : "008" ,
"InitialValue" : 1000 ,
"FinalValue" : 2000 ,
"InitialCounter" : "001" ,
"FinalCounter" : "050" ,
"ValueCancellations" : 1 ,
"SalesValueNet" : 2 ,
"TaxReplacementValue" : 3 ,
"DiscountValue" : 4 ,
"FreeValue" : 5 ,
"UntaxedValue" : 6 ,
"IcmsBas7" : 7 ,
"IcmsBas12" : 8 ,
"IcmsBas18" : 9 ,
"IcmsBas25" : 0 ,
"CounterCode" : "" ,
"ValueOfOthersReceivables" : 0 ,
"AmountOfTaxDue" : 0 ,
"IssValue" : 0 ,
"ReductionSituation" : "RR" ,
"CounterReset" : "5" ,
"IcmsBasMG" : 12 ,
"Details" : "REDUCTION Z" ,
"IssueDateReduction" : "2019-08-26T13:17:21",
"IssueHourReduction" : "10:15",
"LastDocBC" : "" ,
"LastDocA" : "" ,
"DocFiscalValue" : 0 ,
"IvafiscalValue" : 0 ,
"TaxIntValue" : 0 ,
"TaxPercent" : 0 ,
"LastNccBC" : "" ,
"LastNccA" : "" ,
"NccValue" : 0 ,
"IvaNccValue " : 0 ,
"IntNccValue" : 0 ,
"NccPercent" : 0 ,
"LastRemit" : "" ,
"Md5" : "" ,
"Bas12Rate" : "" ,
"Bas18Rate" : "" ,
"Bas25Rate" : "" ,
"Bas7Rate" : "" ,
"IssDiscount" : 0 ,
"IssCancellations" : 0 ,
"Md5Tax" : ""
}


Destino das informações SFI:

   

BranchIdFI_FILIAL     
MovementDateFI_DTMOVTO    
IdFI_NUMERO     
PosNumberFI_PDV    
PosSerieNumberFI_SERPDV     
ReductionCodeFI_NUMREDZ    
InitialValueFI_GTINI      
FinalValueFI_GTFINAL    
InitialCounterFI_NUMINI     
FinalCounterFI_NUMFIM     
ValueCancellationsFI_CANCEL     
SalesValueNetFI_VALCON     
TaxReplacementValueFI_SUBTRIB    
DiscountValueFI_DESC       
FreeValueFI_ISENTO     
UntaxedValueFI_NTRIB      
IcmsBas7FI_BAS7       
IcmsBas12FI_BAS12      
IcmsBas18FI_BAS18      
IcmsBas25FI_BAS25      
CounterCodeFI_COO        
ValueOfOthersReceivablesFI_OUTROSR    
AmountOfTaxDueFI_IMPDEBT    
IssValueFI_ISS        
ReductionSituationFI_SITUA      
CounterResetFI_CRO        
IcmsBasMGFI_BAS001     
DetailsFI_OBS        
IssueDateReductionFI_DTREDZ     
IssueHourReductionFI_HRREDZ     
LastDocBCFI_DOCBC      
LastDocAFI_DOCA       
DocFiscalValueFI_DOCFIS     
IvafiscalValueFI_IVAFIS     
TaxIntValueFI_IINTFIS    
TaxPercentFI_PERCFIS    
LastNccBCFI_NCREDBC    
LastNccAFI_NCREDA     
NccValueFI_NCRED      
IvaNccValue  FI_IVANCC     
IntNccValueFI_IINTNCC    
NccPercentFI_PERCNCC    
LastRemitFI_ULTREMI    
Md5         FI_PAFMD5     
Bas12RateFI_COD12      
Bas18RateFI_COD18      
Bas25RateFI_COD25      
Bas7RateFI_COD7       
IssDiscountFI_DESISS     
IssCancellationsFI_CANISS     
Md5Tax      FI_MD5TRIB    



URL - http://{serverUrl}:{serverRestPort}  /api/retail/v1/RetailReduction/

  • serverUrl = Endereço para acesso ao servidor Rest;

  • serverRestPort = Porta para acesso ao servidor Rest;

05. ASSUNTOS RELACIONADOS

Para maiores informações consulte as FAQs do Varejo.

Dúvidas Frequentes - Varejo