Este artigo descreve o mapeamento entre o Modelo de Objetos de Documento (DOM) da RetailForce e o modelo iEKA lituano.
Mapeamento de documentType
Na Lituânia, é feita uma distinção básica entre os seguintes tipos de documento (referidos como «tipo de documento»):
- FiscalReceipt — transações de venda
- nonFiscalReceipt — documentos para diferentes finalidades
- FiscalDay — relatório de fecho diário
No âmbito dos nonFiscalReceipts, existem outros tipos que servem para estabelecer distinções adicionais.
Todos os tipos (fiscalReceipt, nonFiscalReceipt, FiscalDay) devem ser enviados para o sistema iEKA e são, por conseguinte, «documentos fiscais» de acordo com a definição da RetailForce, ou seja, documentos que devem ser fiscalizados. A única diferença reside no facto de os nonFiscalReceipts, ao contrário dos fiscalReceipts e dos documentos FiscalDay, não serem assinados através de um módulo de segurança.
| Lituânia | DocumentType RetailForce | ||||
| Tipo | Tipo | Descrição | N.º | Descrição | Notas |
| reciboFiscal | recibo | Recibo de caixa registadora — venda de bens/serviços | 0 | Recibo | - |
| recibo fiscal | recibo | Recibo null | 1000 | Recibo nulo | - |
| nonFiscalReceipt | documento de devolução não fiscal | Recibo de caixa para registo de devoluções/trocas e reembolsos | 0 | Recibo |
Tipo de documento idêntico ao de um recibo de caixa normal. Correspondência: IF
|
| nonFiscalReceipt | documento de cancelamento não fiscal | Interrupção de uma transação antes da conclusão, transação incompleta | 0 | É gerado um | é gerado quando o ponto final POST /api/v1/transactions/cancelDocument é chamado. |
| - | - | - | 1 | Fatura | Atualmente não suportado |
| - | - | - | 2 | Nota de entrega | Atualmente não suportado |
| nonFiscalReceipt | Documento de cobrança não fiscal |
Operação de pagamento, levantamento de dinheiro da caixa | 10 | Pagamento | As operações de pagamento devem ser transmitidas com valores NEGATIVOS (GrossValue, Amount, etc.) |
| nonFiscalReceipt | documento financeiro não fiscal |
Operações específicas relacionadas com farmácias | 10 | Pagamento | Atualmente não suportado |
| nonFiscalReceipt | documento de cobrança não fiscal | Operações de depósito, por exemplo, depósito de trocos | 11 | PayIn | As operações de PayIn devem ser transmitidas com valores POSITIVOS (GrossValue, Amount, etc.) |
| nonFiscalReceipt | documento financeiro não fiscal | Operações específicas relacionadas com farmácias | 11 | PayIn | Atualmente não suportado |
| - | - | - | 12 | ProformaInvoice | De momento não é suportado |
| - | - | - | 13 | Encomenda do Cliente | Não é suportado neste momento |
| nonFiscalReceipt | Documento de pré-encomenda | - | 14 | PreliminaryReceipt | - |
| - | - | - | 15 | Recibo de pagamento | Atualmente não suportado |
| - | - | - | 80 | LongTermOrder | Tipo de documento suportado |
| nonFiscalReceipt | Documento de cobrança não fiscal | Operações de depósito, por exemplo, depósito de trocos | 90 | OpeningBalance | é tratado como um PayIn |
| nonFiscalReceipt | documento não fiscal | «Relatório (X)» — relatório intercalar | 98 | CashCheck | É possível gerar um CashCheck através do ponto de extremidade GET /api/v1/closing/{clientId}/endofdayDocument. No entanto, antes de um storeDocument, os campos documentType e documentCaption devem ser ajustados em conformidade |
| dia fiscal | fiscalDay | «Relatório (Z)» — relatório de encerramento diário | 99 | EndOfDay | Um documento «EndOfDay» pode ser gerado através do ponto de extremidade GET /api/v1/closing/{clientId}/endofdayDocument e armazenado através de storeDocument. |
| - | - | - | 100 | Inventário | Atualmente não suportado |
| nonFiscalReceipt | Documento financeiro não fiscal | Estrutura «Outras operações de cobrança de dinheiro» (collectionType: 3 – compra) | 101 | Compra | Atualmente não suportado |
| - | - | - | 1001 | Impressão de recibo | Não suportado neste momento |
| - | - | - | 1100 | DiversosNãoFiscal | Atualmente não suportado |
Mapeamento de PaymentType
A tabela seguinte apresenta os métodos de pagamento descritos na documentação técnica do sistema iEKA da Lituânia e o respetivo mapeamento para o RetailForce DOM.
| <PAYMENTTYPE> iEKA Lituânia | "PaymentType" RetailForce | Notas | |
| 1 - Dinheiro | Dinheiro | 0 | Pagamento em dinheiro |
| 2 - Pagamento com cartão de débito/crédito | EcCard | 1 | pagamento com cartão de débito |
| 2 - Pagamento com cartão de débito/crédito | CreditCard | 2 | pagamento com cartão de crédito |
| 3 - Outro cartão de pagamento (por exemplo, cartão de loyalty) | Loyalty | 13 | |
| 4 - Vouchers | MultiPurposeVoucher | 4 | Os Vouchers de Finalidade Única (3) não são atualmente suportados como PaymentType, devendo ser transferidos no elemento «posições». |
| 5 - Vale postal | BankAccount | 11 | Pagamento por transferência bancária |
| 6 - Reembolsado pelo orçamento do Fundo de Seguro de Saúde Obrigatório | não suportado | ||
| 7 - Reembolsado pelo orçamento do Estado | não suportado | ||
| 8 - Criptomoeda | Criptomoeda | 9 | |
| 9 - Outros | não suportado | ||
| Estrutura «Outras Operações de Cobrança em Dinheiro» (collectionType 1 – depósito) | Depósito | 6 | Não é suportado na Lituânia como método de pagamento específico, mas sim como «cashCollectionOperation» |
| 10 - Arredondamento | não constitui um método de pagamento distinto no RetailForce, mas é representado pelo elemento «arredondamento» (document.positions.rounding). | ||
| NoCash | 7 | Atualmente não é suportado | |
| Nenhum | 8 | Não é suportado neste momento | |
| Aplicações para telemóveis | 10 | Não é suportado neste momento | |
| Cartão de Cliente | 12 | Atualmente não suportado | |
| Cheque | 14 | Atualmente não suportado | |
| CreditNote | 15 | Atualmente não suportado | |
Mapeamento de BusinessTransactionType
Os BusinessTransactionTypes do RetailForce são, essencialmente, mapeados para as chamadas «operações» na Lituânia.
| Lituânia | RetailForce | |
| Operação | N.º | BusinessTransactionType |
| Operação de vendas | 0 | Revenue |
| Adicionamentos de descontos | 1 | Desconto |
| Operação de pagamento (collectionType 1 – depósito) | 2 | Depósito de embalagens vazias |
|
PaymentType 4 – vales PayOutType 4 – vales |
3 | Voucher de Finalidade Única |
|
PaymentType 4 – vales PayOutType 4 – vales |
4 | MultiPurposeVoucher |
|
Não registado As gorjetas não são descritas como uma transação comercial no setor do retalho/hotelaria na legislação lituana. São tratadas como rendimento pessoal. |
5 | Gorjeta |
| Não registado. | 6 | Gorjeta da empresa |
| Operação PayIn (tipo de cobrança 1 – depósito) | 7 | Depósito |
| Outras operações de cobrança em dinheiro (direção de cobrança OUT) | 10 | Pagamento |
| Outras operações de cobrança de dinheiro (direção de cobrança IN) | 11 | PayIn |
| Outras operações de cobrança de dinheiro (direção de cobrança IN ou OUT) | 90 | MoneyTransfer |
| Atualmente não suportado | 91 | Diferença de dinheiro |
| Não suportado | 92 | |
| Não suportado | 93 | |
collectionTypes
Outras transações de pagamento são representadas por «collectionTypes».
| Lituânia | RetailForce | |
| collectionType | N.º | Correspondência |
| Depósito | 1 |
PaymentType: [6] = Depósito BusinessTransactionType: [7] = Depósito |
| Outros | 2 | não mapeado |
| Compra | 3 | Atualmente não suportado |
| Reembolso | 4 |
SE:
|
The RetailForce system records communication with the iEKA system. These debugging data are stored in the folder C:\ProgramData\RetailForce\Fiscal Webservice\{clientId}\lithuaniaFiscalFiles.
Para mais detalhes, consulte o artigo «Comunicação com o iEKA».
Este artigo foi traduzido automaticamente.
Comentários
0 comentários
iniciar sessão para comentar.