O
- POST /api/v1/management/clients/initialize
é utilizado para
- inicializar a unidade fiscal (cliente),
- qualquer equipamento fiscal necessário (unidade de criação de assinatura, dispositivo técnico de segurança, unidade de controlo, impressora/caixa fiscal,...) e
- para registar o sistema de registo eletrónico (caixa registadora) junto das autoridades fiscais. (por exemplo, processo de registo no FinanzOnline — Áustria)
Resultado
No caso de um processamento bem-sucedido (200),
- o Cliente Fiscal correspondente e
- qualquer equipamento fiscal necessário são colocados em funcionamento e configurados e
- (se necessário / disponível no respetivo país) a caixa registadora é registada junto da autoridade fiscal.
Utilização
- Única vez, no âmbito da colocação em funcionamento de um client fiscal.
Pré-requisitos
- Middleware fiscal instalado,
- Fiscal Client criado e configurado, quer através de
- PUT /api/v1/management/clients ou
- PUT /api/v1/management/clients/byCloud
- execução bem-sucedida do CloudConnect (apenas para sistemas ligados à RetailForce Cloud).
- O documento inicial foi criado; quer através de GET /api/v1/transactions/document/{clientId}/start, quer pelo próprio sistema a montante.
Campos do formulário
Deve ser enviado um documento inicial para o ponto de extremidade.
Quando a chamada GET /api/v1/transactions/document/{clientId}/start foi efetuada, foi devolvido ao sistema anfitrião um documento inicial como resposta. Este pode agora ser enviado para o ponto de extremidade POST /api/v1/management/clients/initialize.
Em alternativa, o documento inicial necessário pode ser criado pelo próprio sistema a montante.
Respostas
Respostas possíveis:
| Código | Descrição | Exemplo |
| 200 |
O documento inicial foi transmitido com sucesso e sem erros e guardado no documentStore. Além disso, é devolvida uma «fiscalResponse» ao sistema a montante. Esta deve ser armazenada no diário do sistema a montante para efeitos de referência. |
fiscalResponse |
| 204 |
O documento inicial foi transmitido com sucesso e sem erros e guardado no documentStore. Em alguns países, não é transmitida qualquer «fiscalResponse» após o comissionamento bem-sucedido. |
- |
| 422 |
O documento de início não corresponde aos requisitos do respetivo país ou falta o clientId no documento de início. Resolução de problemas:
|
- |
| 500 |
Erro de validação no documento inicial ou o clientId transmitido no documento inicial não foi encontrado no ConfigStore. Resolução de problemas:
|
- |
Este artigo foi traduzido automaticamente.
Comentários
0 comentários
iniciar sessão para comentar.