Geração de Cruzamento
Nesta seção, serão apresentadas algumas solicitações mais requisitadas para a geração de cruzamento
1 - Tabela de Cruzamentos
Os cruzamentos disponíveis, e os seus respectivos parâmetros, estão especificados na tabela abaixo:
| CRUZAMENTO | PATH |
|---|---|
| DAMEF vs SPED | damef-spf |
| DCTF vs ECAC | dctf-ecac |
| DCTF X PERDCOMP | dctf-perdcomp |
| DIRF vs DCTF | dirf-dctf |
| DIRF vs ECAC | dirf-ecac |
| ECD vs DCTF | ecd-dctf |
| ECD vs EFD CONTRIBUIÇÕES | spc-spis |
| ECF vs DCTF | ecf-dctf |
| ECF vs DIRF | ecf-dirf |
| ECF vs ECD | ecf-ecd |
| ECF vs Sped Fiscal | ecf-spedfiscal |
| EFD Contribuições vs CTe | efd-cte |
| EFD CONTRIBUIÇÕES vs DCTF | efd-dctf |
| EFD Contribuições vs NFE | efd-nfe |
| EFD CONTRIBUIÇÕES vs SPED FISCAL | efd-spedfiscal |
| ESOCIAL vs REINF | esoc-reinf |
| SINTEGRA vs NFE | snt-nfe |
| SPED FISCAL vs CTE | spf-cte |
| SPED FISCAL vs DCTF | spedfiscal-dctf |
| SPED FISCAL vs NFE | spf-nfe |
| SPED FISCAL vs NFCE | spf-nfce |
| SPED FISCAL vs OBRIGAÇÕES ESTADUAIS | spf-gia |
| SPED FISCAL vs RECOF | spf-recof |
| SPED FISCAL vs SAT | spf-cfe |
| SPED FISCAL vs XML | spf-xml |
| SPED vs GIAST | spf-giast |
| SPED vs SEF | sped-sef |
Os cruzamentos triplos, e os seus respectivos campos obrigatórios, estão especificados na tabela abaixo. Utilize o path correspondente no endpoint do item 2.
| CRUZAMENTO | PATH | CAMPOS OBRIGATÓRIOS |
|---|---|---|
| DCTF vs ECAC vs PERDCOMP | dctf-ecac-per-dcomp |
|
| EFD vs DCTF vs ECAC | efd-dctf-ecac |
|
| ECF vs DCTF vs ECAC | ecf-dctf-ecac |
|
| EFD vs ECAC vs PERDCOMP | efd-ecac-per-dcomp |
|
| MIT vs e-CAC vs PER/DCOMP | mit-ecac-per-dcomp |
|
| ECF vs MIT vs e-CAC | ecf-mit-ecac |
|
| EFD Contribuições vs MIT vs e-CAC | spis-mit-ecac |
|
2 - Geração de cruzamento triplo
OBS: Todas as chamadas para a geração de cruzamento são realizadas na API de https://corewebapi.asisprojetos.com.br
Neste método o cruzamento triplo é gerado a partir dos parâmetros informados no corpo da requisição. O path identifica o produto, conforme a segunda tabela do item 1. Informe pelo menos uma empresa em empresas.
POST /api/v1/cruzamento/triplo/{path}
Parâmetros:
- path: path identificador do cruzamento triplo, conforme a segunda tabela do item 1
Headers:
- app-key: chave do aplicativo
- account-key: chave da conta
- Content-Type: application/json
Request:
Exemplo para dctf-ecac-per-dcomp (também válido para efd-dctf-ecac, ecf-dctf-ecac e efd-ecac-per-dcomp):
curl -X POST "https://corewebapi.asisprojetos.com.br/api/v1/cruzamento/triplo/dctf-ecac-per-dcomp" \
-H 'Content-Type: application/json' \
-H 'app-key: 6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb' \
-H 'account-key: b601b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52dcd' \
-d '{
"nomeProcesso": "DCTF vs ECAC vs PERDCOMP",
"empresas": ["12345678000199"],
"uf": "SP",
"mesRefInicial": "202401",
"mesRefFinal": "202412",
"finalidade": 0
}'
Exemplo para mit-ecac-per-dcomp:
{
"nomeProcesso": "MIT vs e-CAC vs PER/DCOMP",
"empresas": ["12345678000199"],
"mesRefInicial": "202401"
}
Exemplo para ecf-mit-ecac:
{
"nomeProcesso": "ECF vs MIT vs e-CAC",
"empresas": ["12345678000199"],
"uf": "SP",
"anoRef": "2024"
}
Exemplo para spis-mit-ecac:
{
"nomeProcesso": "EFD Contribuições x MIT x e-CAC",
"empresas": ["12345678000199"],
"uf": "SP",
"mesRefInicial": "2026-09-01",
"mesRefFinal": "2026-09-30"
}
Response:
- HTTP Status 201 Created com JSON contendo o processo de cruzamento criado. Exemplo:
{
"arquivoId": 0,
"cnpj": "12345678000199",
"dataHoraCriacao": "2026-09-29T13:15:51.395Z",
"dataHoraExportacao": null,
"dataHoraFim": null,
"dataHoraInicio": "2026-09-29T13:15:51.395Z",
"diagnostico": {
"advertencia": 0,
"beneficio": 0,
"erro": 0,
"relatorio": 0
},
"finalidade": 0,
"id": 12345,
"informacao": {
"cnpj": "12345678000199",
"encode": "string",
"finalArquivo": "string",
"finalidade": 0,
"indiceInicial": 0,
"layout": "string",
"mesRef": "202401",
"produtoId": 85,
"quantidadeTotal": 0,
"razaoSocial": "string",
"status": "string",
"uf": "SP",
"versao": "string",
"xargs": "string"
},
"mesRef": "202401",
"nome": "DCTF vs ECAC vs PERDCOMP",
"nomeUsuario": "string",
"processoPai": 0,
"produto": {
"ativo": true,
"id": 85,
"nome": "DCTF vs ECAC vs PERDCOMP",
"prefixo": "string"
},
"quantidadeResultado": 0,
"quantidadeTotal": 0,
"razaoSocial": "string",
"status": 0,
"uf": "SP"
}
- HTTP Status 400 Bad Request quando o path é inválido, faltam campos obrigatórios ou o formato está incorreto. Exemplo:
{
"timestamp": "2026-09-29T13:15:51.395Z",
"status": 400,
"error": "Bad Request",
"message": "Requisição inválida para o cruzamento 'efd-dctf-ecac'. Verifique os campos obrigatórios e os formatos informados.",
"errors": [
{
"field": "mesRefInicial",
"message": "O campo mesRefInicial deve estar no formato AAAAMM, com mês entre 01 e 12"
},
{
"field": "empresas",
"message": "Informe pelo menos uma empresa para o cruzamento 'efd-dctf-ecac'"
}
]
}
- HTTP Status 400 Bad Request quando o path informado não existe. Exemplo:
{
"timestamp": "2026-09-29T13:15:51.395Z",
"status": 400,
"error": "Bad Request",
"message": "Path de cruzamento triplo inválido: 'dctf-ecac'. Paths aceitos: dctf-ecac-per-dcomp, efd-dctf-ecac, ecf-dctf-ecac, efd-ecac-per-dcomp, mit-ecac-per-dcomp, ecf-mit-ecac, spis-mit-ecac"
}
3 - Geração automática de cruzamento
OBS: Todas as chamadas para a geração de cruzamento são realizadas na API de https://corewebapi.asisprojetos.com.br
Neste método informa-se somente o ID do processo do produto predominante. Os processos a serem cruzados são buscados automaticamente. O produto predominante é o produto que aparece primeiro no nome do cruzamento. Exemplo: FISCAL vs DCTF , o produto predominante é FISCAL.
POST /api/v1/cruzamento/{path}/{processo}
Parâmetros:
- path: path identificador do cruzamento, conforme tabela do item 1
- processo: ID do processo do produto predominante
Headers:
- app-key: chave do aplicativo
- account-key: chave da conta
Response:
- JSON contendo o processo de cruzamento criado. Exemplo:
{
"arquivoId": 0,
"cnpj": "string",
"dataHoraCriacao": "2020-12-30T13:15:51.395Z",
"dataHoraExportacao": "2020-12-30T13:15:51.395Z",
"dataHoraFim": "2020-12-30T13:15:51.395Z",
"dataHoraInicio": "2020-12-30T13:15:51.395Z",
"diagnostico": {
"advertencia": 0,
"beneficio": 0,
"erro": 0,
"relatorio": 0
},
"finalidade": 0,
"id": 0,
"informacao": {
"cnpj": "string",
"encode": "string",
"finalArquivo": "string",
"finalidade": 0,
"indiceInicial": 0,
"layout": "string",
"mesRef": "string",
"produtoId": 0,
"quantidadeTotal": 0,
"razaoSocial": "string",
"status": "string",
"uf": "string",
"versao": "string",
"xargs": "string"
},
"mesRef": "string",
"nome": "string",
"nomeUsuario": "string",
"processoPai": 0,
"produto": {
"ativo": true,
"id": 0,
"nome": "string",
"prefixo": "string"
},
"quantidadeResultado": 0,
"quantidadeTotal": 0,
"razaoSocial": "string",
"status": 0,
"uf": "string"
}
4 - Geração avançada de cruzamento
Neste método informa-se o ID do processo predominante e também os IDs dos processos a serem cruzados.
O produto predominante é o produto que aparece primeiro no nome do cruzamento. O produto a ser cruzado é o segundo. Exemplo: SPED FISCAL vs DCTF, o produto predominante é SPED FISCAL e o produto a ser cruzado é DCTF.
POST /api/v1/cruzamento/{path}/{processoA}/{processosB}
Parâmetros:
- path: path identificador do cruzamento, conforme tabela do item 1
- processoA: ID do processo do produto predominante
- processosB: IDs dos processos a serem cruzados, separados por vírgula
Headers:
- app-key: chave do aplicativo
- account-key: chave da conta
Response:
- JSON contendo o processo de cruzamento criado. Exemplo:
{
"arquivoId": 0,
"cnpj": "string",
"dataHoraCriacao": "2020-12-30T13:15:51.395Z",
"dataHoraExportacao": "2020-12-30T13:15:51.395Z",
"dataHoraFim": "2020-12-30T13:15:51.395Z",
"dataHoraInicio": "2020-12-30T13:15:51.395Z",
"diagnostico": {
"advertencia": 0,
"beneficio": 0,
"erro": 0,
"relatorio": 0
},
"finalidade": 0,
"id": 0,
"informacao": {
"cnpj": "string",
"encode": "string",
"finalArquivo": "string",
"finalidade": 0,
"indiceInicial": 0,
"layout": "string",
"mesRef": "string",
"produtoId": 0,
"quantidadeTotal": 0,
"razaoSocial": "string",
"status": "string",
"uf": "string",
"versao": "string",
"xargs": "string"
},
"mesRef": "string",
"nome": "string",
"nomeUsuario": "string",
"processoPai": 0,
"produto": {
"ativo": true,
"id": 0,
"nome": "string",
"prefixo": "string"
},
"quantidadeResultado": 0,
"quantidadeTotal": 0,
"razaoSocial": "string",
"status": 0,
"uf": "string"
}