Como Iniciar

Nesta seção, serão apresentadas algumas solicitações mais requisitadas e suas respectivas respostas na Asis API

Criar Conta

Normalmente, todos ERP, Aplicativos e Sistemas de Gestão possuem modelagens multi empresa, multi clientes etc. Seguindo essa abordagem, para cada cliente de seu aplicativo, é recomendável criar uma conta, para segregar e isolar seus respectivos processos, empresas, arquivos e resultados.

Request

url -X POST \
https://corewebapi.asisprojetos.com.br/api/v1/conta \
-H 'app-key: 4e07408562bedb8b60ce05c1decfe3ad16b72230967de01f640b7e' \
-d '{
       "cargo" : "Gerente Fiscal",
       "cnpj": "64555018000134",
       "email" : "jose.silva@grupomedeiros.com",
       "nomeEmpresa" : "Grupo Medeiros",
       "nomeProprietario" : "José Silva",
       "razaoSocial" : "Grupo Medeiros LTDA"
    }'
    

Response

{
    "id": 17,
    "chave": "6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb",
    "dataCriacao": "02-01-2018 16:26:05",
    "ativo" : true,
    "proprietario": {
        "id": 7654,
        "email": "jose.silva@grupomedeiros.com.br",
        "nome": "José Silva",
        "cargo": "Gerente Fiscal",
        "admin": true,
        "dataCriacao": "02-01-2018 16:26:05"
    },
    "empresa": {
        "id": 3456,
        "nome": "Grupo Medeiros",
        "cnpj": "64555018000134",
        "razaoSocial": "Grupo Medeiros LTDA",
        "dataCriacao": "02-01-2018 16:26:05"
    }
}
    

Upload

Realiza upload de arquivos retornando o identificador (id) do processo

Request

curl -X POST \
  https://file.asisprojetos.com.br/api/v1/upload \
  -H 'account-key: 4e07408562bedb8b60ce05c1decfe3ad16b72230967de01f640b7e' \
  -H 'app-key: 6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb' \
  -F 'file=@path/to/file/sped_fiscal.txt
    

Response

{"processos":[
    {
        "id":22362,
        "nome":"sped_fiscal.txt",
        "dataHoraCriacao":"06-06-2018 12:34:46",
        "arquivoId":22740
    }
]}
    

Consulta Processo

Consulta um processo a partir de um ID obtido a partir de um upload e/ou outro gatilho

Request

curl -X GET \
  https://corewebapi.asisprojetos.com.br/api/v1/processo/22362 \
  -H 'account-key: 4e07408562bedb8b60ce05c1decfe3ad16b72230967de01f640b7e' \
  -H 'app-key: 6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb'
    

Response

{
    "id":22742,
    "nome":"sped_fiscal.txt",
    "dataHoraCriacao":"06-06-2018 12:34:46",
    "dataHoraInicio":"06-06-2018 12:34:47",
    "dataHoraFim":"06-06-2018 12:35:11",
    "status":201,
    "arquivoId":22360
}
    

Status dos processos

Conheça os possíveis status que podem ocorrer durante a consulta de processos

DESCRIÇÃO	STATUS
Upload Concluído	0
Fila de Identificação	1
Arquivo Disponível para Import. / Processo	100
Importando Arquivo	101
Importação Concluída	200
Processando Arquivo	102
Processamento Concluído	201
Erro de Importação	400
Erro de Processamento	500
Arquivo Não Identificado	401
Erro Interno	402

Consulta Resultados de um processo

Resultado sintético de um processo obtido pelo seu identificador (ID)

Request

curl -X GET \
  https://resultadowebapi.asisprojetos.com.br/api/v1/resultado/processo/22362 \
  -H 'account-key: 4e07408562bedb8b60ce05c1decfe3ad16b72230967de01f640b7e' \
  -H 'app-key: 6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb'

    

Response

[
    {
        "diagnostico":"R",
        "codigo":538,
        "ementa":"DE ACORDO COM OS DADOS CONTIDOS NO ARQUIVO, FOI VERIFICADO A AUSÊNCIA DO CÓDIGO DA CONTA ANALÍTICA CONTÁBIL DEBITADA OU CREDITADA. FUNDAMENTO LEGAL: Ato ICMS/COTEPE Nº 9 DE 18/04/2008 - GUIA PRÁTICO DA ESCRITURAÇÃO FISCAL DIGITAL - EFD.",
        "auditoriaId":110,
        "nivel":1,
        "nome":"538 Ausência do COD_CTA Transporte",
        "qtdeResultados":355,
        "resultadoId":5541810
    },
    {
        "diagnostico":"Y",
        "codigo":2396,
        "ementa":"Identificamos a ausência de escrituração do Registro D197 no arquivo." ,
        "auditoriaId":315,
        "nivel":1,
        "nome":"2396 Alerta de Ausência de Escrituração do Registro D197",
        "qtdeResultados":1,
        "resultadoId":5541861
    },
    {
        "diagnostico":"W",
        "codigo":140,
        "ementa":"OS VALORES AQUI A APRESENTADOS DEVERÃO CORRESPONDER AO VALOR CONTÁBIL EQUIVALENTE AS ENTRADAS DE DOCUMENTOS FISCAIS.",
        "auditoriaId":83,
        "nivel":4,
        "nome":"140 Relatório Valor Contábil de Docs Fiscais de Entrada",
        "qtdeResultados":1,
        "resultadoId":5542160
    },
    {
        ...
    }
]
    

Consulta Resultados de um processo e auditoria

Resultado analitico de itens de retorno de um processo e auditoria

Request

curl -X GET \
  https://resultadowebapi.asisprojetos.com.br:8082/api/v1/resultado/processo/22362/auditoria/110 \
  -H 'account-key: 4e07408562bedb8b60ce05c1decfe3ad16b72230967de01f640b7e' \
  -H 'app-key: 6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb'
    

Response

{
    "cabecalho":[
        "REG",
        "COD_CTA",
        "NUM_DOC",
        "DT_ENTR_SAÍDA",
        "VL_DOC",
        "COD_SIT",
        "CFOP",
        "SITUAÇÃO",
        "CHV_CTE"
    ],
    "dados":[
        [
            "D100",
            "null",
            "4034",
            "2018-02-20",
            "360.00",
            "0",
            "5353",
            "Documento regular",
            "43180223823221000165570010000040341570562539"
        ],
        [
            "D100",
            "null",
            "3975",
            "2018-02-16",
            "300.00",
            "0",
            "5353",
            "Documento regular",
            "43180223823221000165570010000039751287071250"
        ],
        [
            "D100",
            "null",
            "3875",
            "2018-02-10",
            "1325.50",
            "0",
            "5353",
            "Documento regular",
            "43180223823221000165570010000038751472150190"
        ],
        [
            "D100",
            "null",
            "3764",
            "2018-02-03",
            "200.00",
            "0",
            "5353",
            "Documento regular",
            "43180223823221000165570010000037641383359370"
        ],
        [
            "D100",
            "null",
            "3942",
            "2018-02-15",
            "100.00",
            "0",
            "5353",
            "Documento regular",
            "43180223823221000165570010000039421061629860"
        ],
        [ ... ]
    ...
    ]
}
    

Próximas etapas

A próxima sessão, você poderá explorar mais sobre Formas de Autenticação disponíveis com a Asis API.