O envio de dados ao SYN é realizado por meio de requisições POST/GET aos endpoints da API, acompanhadas de um cabeçalho JSON com informações de identificação e controle. A comunicação deve ser iniciada pelo sistema da empresa junto ao SYN antes do envio dos dados propriamente ditos.
Os endpoints estão organizados por contexto de uso. Selecione o ambiente adequado antes de realizar as chamadas:
Homologação: https://synhomologacao.questor.com.br/index.html
Produção: https://syn.questor.com.br/index.html
Os endpoints estão subdivididos em três grupos: Dados, Empresa e Escritório.
Dados — Empresa | Dados [Leiautes txt]
POST /api/v2/dados/inserirPUT /api/v2/dados/substituirGET /api/v2/dados/buscar-log-e-status-dadosPOST /api/v2/dados/invalidarregistroControle de Tributos — Empresa | Controle Tributos
GET /api/v2/debito-tributario/buscar-log-e-statusPOST /api/v2/empresa/opcaodebitostributariosGET /api/v2/empresa/buscardebitostributariosPOST /api/v2/empresa/debitotributariobaixadoPOST /api/v2/empresa/log-atualiza-status-debitostributariosDocumentos Fiscais — Empresa | DocFiscal [xml]
POST /api/v2/docfiscal/inserirDocumentos Fiscais — Escritório | DocFiscal [xml]
POST /api/v2/docfiscal/confirmacaorecebimentoO POST de dados deve ser enviado com as informações de cabeçalho e o arquivo no campo dado, estruturados em JSON String, conforme descrito na Documentação de Dados. O cabeçalho deve conter os dados dos interessados na importação, a versão do layout, o grupo de dados, a data da movimentação e os CNPJs da empresa e da contabilidade autorizada.
{
"cnpjCliente": "12.345.678/0001-00",
"versao": "2.00",
"grupoLayout": 100,
"dataDocumentos": "31/12/2021",
"dado": "string",
"cnpjContabilidade": ["98.765.432/0001-00"]
}
Os campos abaixo compõem o corpo da requisição e devem ser preenchidos conforme as orientações a seguir.
2.00.001 — Plano de Contas ERP.100 — Lançamentos Contábeis.200 — Entradas (Movimentação Fiscal).201 — Saídas (Movimentação Fiscal).202 — Pagamentos (Pagamentos de Duplicatas).203 — Recebimentos (Recebimentos de Duplicatas).300 — Lançamentos Inventário.301 — Bloco K (Inventário).DD/MM/AAAA. Deve corresponder à data de movimentação presente no campo dado.⚠️ Atenção!
A API possui limite de 2 consultas por segundo. Se esse limite for excedido, a API retornará o código HTTP429 (Too Many Requests).