Comunicação de documentos à AT
Comunicação de documentos via API
Pode enviar 3 tipos de documentos à Autoridade Tributária:
- sales_document: documentos de venda
- shipment_document: guias
- purchases_shipment_document: guias de devolução a fornecedor
De modo a comunicar um documento, deverá realizar um pedido POST, para o endpoint: send_document_at_webservice
patch
/send_document_at_webservice
Comunicação de documentos
curl -v -X POST -H 'Content-Type: application/vnd.api+json'\
-H 'Accept: application/json'\
-H 'Authorization: Bearer <access_token>'\
-d '<payload JSON>' '<API_URL>/send_document_at_webservice'
O payload a utilizar para a comunicação é o seguinte:
{
data: {
type: 'send_document_at_webservice',
id: '<document_id>',
attributes: {
document_type: '<document_type>',
entity_password: '<at_password_base_64>',
entity_username: '<at_username>'
}
}
}
A resposta ao pedido trará informação sobre o sucesso/insucesso da operação no seguinte formato:
{
data: {
type: 'send_document_at_webservice',
id: '<document_id>',
attributes: {
communication_status: <communciation_status>,
communication_code: <communication_code>,
communication_message: <communication_message>
}
}
}
O campo communication_code terá o código de comunicação à Autoridade Tributária no caso do documento comunicado ter sido uma guia (vendas ou compras).
Last modified 5mo ago