Saltar al contenido principal

Proceso básico de transferencia de documentos

Harald Krondorfer
  • Actualización

Creación del módulo fiscal

Para transferir documentos fiscales (datos fiscales), primero debe crear un módulo fiscal. Esto puede realizarse de varias formas:

  • Si utiliza el servicio fiscal de confianza (servicio de Windows o Linux), el servicio fiscal creará automáticamente el módulo fiscal por usted.
  • Si se prevé integrar el módulo fiscal mediante la integración directa de DLL de .NET, deberá instanciar el módulo fiscal por su cuenta. A continuación encontrará una descripción detallada:
    Crear/instanciar el módulo fiscal
Atención: El módulo fiscal inicializa varios submódulos y no debe crearse de nuevo para cada recibo (por ejemplo, la autocomprobación del hardware TSS (Alemania) requiere al menos 30 segundos). Además, es necesario llamar a CloudConnect antes de transferir los documentos; de lo contrario, el archivado en la nube fallará (solo es necesario si el archivado en la nube está habilitado).

Transferencia de documentos

Para transferir documentos fiscales al módulo fiscal, debe seguir al menos dos pasos:

  • createDocument
  • storeDocument

Independientemente del país, se recomienda ejecutar el método CreateDocument en todos los casos.

Atención: el método CreateDocument debe invocarse al inicio del documento (al dar de alta un artículo). Esto es absolutamente necesario para cumplir con la normativa fiscal (p. ej., en Alemania). Debe establecer el campo fiscalResponse del documento que desea almacenar con el valor de fiscalResponse obtenido al invocar el método CreateDocument.

Ejemplo de documento de recibo en formato JSON:

{
"UniqueClientId": "c1062c55-57c4-4ed2-9c53-aff1762326a4",
"DocumentGuid": "5efa5306-fe53-452d-9c81-68329475eee0",
"DocumentId": "2021-02-02T05:31:08.9450964+01:00",
"CreateDate": "2021-02-02T05:31:08.9450964+01:00",
"BookDate": "2021-02-02T05:31:08.9450964+01:00",
"DocumentNumber": null,
"CancellationDocument": false,
"DocumentReference": null,
"IsTraining": false,
"DocumentType": 0,
"DocumentTypeCaption": null,
"User": {
   "Id": "1234",
   "Caption": "Testuser"
},
"AllocationGroups": [],
"Partner": null,
"FiscalResponse": null, 
"FiscalDocumentNumber": 0, // set fiscaldocument of create document here
"FiscalDocumentRevision": 0, // set fisacldocument revision of create document here
"Positions": [
   {
      "ItemCaption": "Blume grün", // the caption of the item
      "ItemShortCaption": null,
      "Discounts": [],
      "Type": 0,
      "UseSubItemVatCalculation": true,
      "SubItems": null,
      "Quantity": 1.0,
      "QuantityUnit": null,
      "ItemId": "000714", // the item id
      "BaseNetValue": 3.61, // base value (without discounts)
      "BaseGrossValue": 4.3,
      "BaseTaxValue": 0.69,
      "GTIN": null,
      "BusinessTransactionType": 0,
      "VatIdentification": 1, 
      "VatPercent": 19.0, 
      "NetValue": 3.61, // net value (quantity * price)
      "GrossValue": 4.3, // gross value of the position
      "TaxValue": 0.69,
      "AccountingIdentifier": null,
      "PositionNumber": 0,
      "PositionReference": null,
      "CancellationPosition": false
   }
],
"Payments": [
   {
      "Amount": 5.0, // payment with over payment
      "IsCash": false,
      "CurrencyIsoCode": "EUR",
      "Caption": null,
      "UniqueReadablePaymentIdentifier": null,
      "ForeignAmount": 0.0,
      "ForeignAmountExchangeRate": 0.0
   },
   {
      "Amount": -0.7, // cash return (second payment)
      "IsCash": false,
      "CurrencyIsoCode": "EUR",
      "Caption": null,
      "UniqueReadablePaymentIdentifier": null,
      "ForeignAmount": 0.0,
      "ForeignAmountExchangeRate": 0.0
   }
]
}

Este recibo contiene:

  • una posición de artículo con el código «000714», «Blume grün», con un precio bruto de 4,3 EUR (1 unidad).
  • 2 pagos: una partida de 5 EUR en efectivo y un cambio de 0,7 EUR
Nota: Para ver cómo debe estructurarse un documento, puede consultar el ejemplo del Fiscal Service Client Sample (C#), que encontrará en la sección de descargas (http://www.retailforce.cloud/downloads ). También muestra el JSON resultante al iniciar la aplicación de ejemplo. Asegúrese de tener el servicio fiscal instalado e iniciado en el mismo equipo.

Para anular un documento creado anteriormente, puede invocar al método:

  • cancelDocument
Atención: Cada documento creado (con createDocument) debe cerrarse con storeDocument o cancelarse con cancelDocument.

Para validar un documento antes de transferirlo al módulo fiscal, puede llamar a

  • ValidateDocument
Información: El documento se validará siempre antes de ser almacenado (incluso si se cancela). Si se produce un error de validación, el método StoreDocument fallará y generará una excepción.

Procesos en detalle

Proceso de ventas al por menor

La venta de mercancías, por ejemplo en el comercio minorista, se desarrolla de la siguiente manera:

Operador Sistema de caja registradora Servicio de fiscalización de RetailForce
1. El operador (usuario de la caja registradora) introduce el primer artículo que el cliente desea adquirir.    
  2. El sistema de caja registradora envía una solicitud al servicio fiscal (createDocument) para registrar el inicio de la transacción correspondiente.  
    3. El servicio fiscal recibe la solicitud del sistema de origen y la procesa de acuerdo con los requisitos específicos de cada país (por ejemplo, firma, etc.).
    4. El servicio fiscal envía una respuesta (fiscalResponse) al sistema de origen.
  5. El sistema de caja registradora (sistema de origen) recibe la respuesta y almacena parte de ella (o el objeto de respuesta completo) para su uso posterior (como referencia) una vez finalizada la transacción.  
6. El operador escanea todos los artículos del cliente e inicia el proceso de pago.    
 

7. Una vez determinados todos los datos de la transacción (artículos, forma de pago, etc.), el sistema de punto de venta genera el payload de la transacción (JSON) y envía otra solicitud al servicio fiscal (storeDocument), lo que completa (guarda) la transacción.

Determinada información de la respuesta fiscal (fiscalResponse) recibida durante la llamada a createDocument debe incluirse en la payload («fiscalDocumentNumber», «fiscalDocumentStartTime» y, si procede, elementos específicos de cada país, como «fiscalDocumentRevision» en Alemania).

Importante: en la payload únicamente deben incluirse los elementos enumerados anteriormente y NO el objeto fiscalResponse completo.
  
    8. El Servicio Fiscal recibe las solicitudes del sistema de origen y las procesa de acuerdo con los requisitos específicos de cada país (p. ej., firma, etc.).
    9. El Servicio Fiscal envía una respuesta (fiscalResponse) al sistema anterior.
  10. El sistema de caja registradora recibe la fiscalResponse, extrae la información necesaria para la creación del documento (p. ej., la firma del documento, el código QR, etc.) e imprime el documento.  
11. El operador entrega el recibo impreso al cliente    

Proceso de venta en el comercio minorista con cancelación de la transacción

Si, tal y como se ha descrito anteriormente, durante el paso 6, es decir, DESPUÉS de enviar createDocument (paso 2) y ANTES de enviar storeDocument (paso 7), el sistema de punto de venta envía un cancelDocument EN LUGAR DE un storeDocument.

Importante: la orden «cancelDocument» se emplea para cancelar (abandonar) una transacción incompleta y NO (!) para gestionar devoluciones.

Las devoluciones se gestionan de la misma forma que las transacciones de venta normales, utilizando createDocument y storeDocument.

 

Este artículo ha sido traducido automáticamente.

Artículos relacionados

Comentarios

0 comentarios

Inicie sesión para dejar un comentario.

Tecnología de Zendesk