Este punto final constituye el primer paso en la transmisión de transacciones desde el sistema de registro electrónico («caja registradora») al Servicio Fiscal. El proceso consta siempre de dos pasos. Este proceso de transmisión de transacciones en dos pasos se basa en los requisitos de la Ordenanza contra la manipulación de cajas registradoras en Alemania y debe llevarse a cabo en todos los países con régimen fiscal en el sentido de una interfaz estandarizada. En Alemania, cuando se invoca PUT /api/v1/transactions/createDocument, se registra una transacción en el denominado dispositivo técnico de seguridad (TSE/TSS).
Registro de la transacción
Una transacción o documento se registra en la unidad fiscal:
- PUT /api/v1/transactions/createDocument y
- POST /api/v1/transactions/storeDocument
Anulación de la transacción
Esto registra la finalización de una transacción en la unidad fiscal:
- PUT /api/v1/transactions/createDocument y
- POST /api/v1/transactions/cancelDocument
Nota: todas las transacciones iniciadas con PUT /api/v1/transactions/createDocument deben cerrarse mediante POST /api/v1/transactions/storeDocument o POST /api/v1/transactions/cancelDocument. Tenga en cuenta la función listTransactions (DELETE).
Resultado
Una llamada correcta al punto final (200)
- registra el inicio de una transacción en la unidad fiscal y
- devuelve una «fiscalResponse» al sistema de origen (sistema de registro electrónico).
Uso
- Cada vez que se vaya a enviar una nueva transacción a la unidad fiscal, antes de llamar a POST /api/v1/transactions/storeDocument o POST /api/v1/transactions/cancelDocument.
Requisitos previos
- Fiskal Client inicializado
Campos del formulario
Se debe enviar la siguiente información:
| Denominación | Tipo | Descripción | Ejemplo |
| clientId | M |
El «uniqueClientId» de la caja registradora (del RetailForce system). | c1062c55-57c4-4ed2-9c53-aff1762326a4 |
| documentType | M |
El tipo de documento que se va a registrar. Enum:
|
- |
| DocumentGuid del documento | R |
El GUID/UUID asignado a la transacción por el sistema TPV. Comportamiento de «DocumentGuid» incluido en la solicitud:
Comportamiento SIN «DocumentGuid» en la solicitud:
Nota: Asimismo, debe utilizarse el mismo «DocumentGuid» en la llamada posterior a POST /api/v1/transactions/storeDocument. |
b5744d8c-71ec-4ea0-a340-53070da8b5a1 |
Respuesta
Respuestas posibles:
| Código | Descripción | Ejemplo |
| 200 | La transacción se ha iniciado y se ha devuelto una «fiscalResponse» al sistema de origen. | - |
Este artículo ha sido traducido automáticamente.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.