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:
BranchId | FI_FILIAL |
MovementDate | FI_DTMOVTO |
Id | FI_NUMERO |
PosNumber | FI_PDV |
PosSerieNumber | FI_SERPDV |
ReductionCode | FI_NUMREDZ |
InitialValue | FI_GTINI |
FinalValue | FI_GTFINAL |
InitialCounter | FI_NUMINI |
FinalCounter | FI_NUMFIM |
ValueCancellations | FI_CANCEL |
SalesValueNet | FI_VALCON |
TaxReplacementValue | FI_SUBTRIB |
DiscountValue | FI_DESC |
FreeValue | FI_ISENTO |
UntaxedValue | FI_NTRIB |
IcmsBas7 | FI_BAS7 |
IcmsBas12 | FI_BAS12 |
IcmsBas18 | FI_BAS18 |
IcmsBas25 | FI_BAS25 |
CounterCode | FI_COO |
ValueOfOthersReceivables | FI_OUTROSR |
AmountOfTaxDue | FI_IMPDEBT |
IssValue | FI_ISS |
ReductionSituation | FI_SITUA |
CounterReset | FI_CRO |
IcmsBasMG | FI_BAS001 |
Details | FI_OBS |
IssueDateReduction | FI_DTREDZ |
IssueHourReduction | FI_HRREDZ |
LastDocBC | FI_DOCBC |
LastDocA | FI_DOCA |
DocFiscalValue | FI_DOCFIS |
IvafiscalValue | FI_IVAFIS |
TaxIntValue | FI_IINTFIS |
TaxPercent | FI_PERCFIS |
LastNccBC | FI_NCREDBC |
LastNccA | FI_NCREDA |
NccValue | FI_NCRED |
IvaNccValue | FI_IVANCC |
IntNccValue | FI_IINTNCC |
NccPercent | FI_PERCNCC |
LastRemit | FI_ULTREMI |
Md5 | FI_PAFMD5 |
Bas12Rate | FI_COD12 |
Bas18Rate | FI_COD18 |
Bas25Rate | FI_COD25 |
Bas7Rate | FI_COD7 |
IssDiscount | FI_DESISS |
IssCancellations | FI_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.