Exibir origem

CONTEÚDO

Visão Geral
Exemplo de utilização
Tabelas utilizadas

01. VISÃO GERAL

Essa API tem como função retornar a quantidade de documentos eletrônicos (NF-e, CT-e, MDF-e, etc.) emitidos em determinado mês.

02. EXEMPLO DE UTILIZAÇÃO

2.1 Namespace da API

- Namespace padrão: /tssconsultavolumetria/v1/tssvolumetria
- Exemplo: URL REST padrão definida: http://localhost:1322/api/tss
- Resultado final: http://localhost:1322/api/tss/tssconsultavolumetria/v1/tssvolumetria

2.2 Método POST

{
    "EMPRESAS": [
            {
                "CNPJ": "XXXXXXXXXXXXXX"
            },
            {
                "ENTIDADE": "XXXXXX"
            }
    ],
    "ANO": "2024",
    "MESES": "1/2",
    "MODELOS": "NFE/CTE"
}

Estrutura esperada
Campo	Pai	Tipo	Tamanho	Observação
Empresas	-	Array	-	Array utilizado para enviar CNPJ ou entidade.
CNPJ	Empresas	String	14	CNPJ da empresa utilizado no TSS.
Entidade	Empresas	String	6	Entidade utilizada pela empresa no TSS.
Ano	-	String	4	Ano que deseja obter a quantidade dos registros.
Meses	-	String	-	Meses que deseja obter a quantidade dos registros.
Modelos	-	String	-	Modelos de documentos que desejo retornar, por exemplo (NF-e, CT-e, MDF-e)

Observação: No Json de exemplo citado acima estamos passando um CNPJ e uma entidade, porém a API foi desenvolvida e entende caso enviar mais de um CNPJ e mais de uma entidade. Caso enviar CNPJ e entidade o sistema irá priorizar a entidade.

Quando realizado apenas o envio do CNPJ a API aglutina na TAG quantidade um valor total somando todas as entidades, ou seja irá pegar todas as entidades daquele CNPJ e caso existir registros na CONSOLID02 irá somar o valor total de todas entidades conforme o exemplo "Sucesso CNPJ".

Caso enviar apenas entidade, irá retornar indicando qual a entidade e a quantidade não será somada, conforme o exemplo de "Sucesso entidade".

{
    "status": "200",
    "message": "Sucesso",
    "CTE": [
        {
            "periodo": "JANEIRO/2024",
            "quantidade": 12,
            "cnpj": "XXXXXXXXXXXXXX"
        },
        {
            "periodo": "FEVEREIRO/2024",
            "quantidade": 12,
            "cnpj": "XXXXXXXXXXXXXX"
        }
    ],
    "NFE": [
        {
            "periodo": "JANEIRO/2024",
            "quantidade": 666,
            "cnpj": "XXXXXXXXXXXXXX"
        },
        {
            "periodo": "FEVEREIRO/2024",
            "quantidade": 65,
            "cnpj": "XXXXXXXXXXXXXX"
        }
    ]
}

{
    "status": "200",
    "message": "Sucesso",
    "NFE": [
        {
            "periodo": "JANEIRO/2024",
            "quantidade": 10,
            "entidade": "XXXXXX"
        },
        {
            "periodo": "FEVEREIRO/2024",
            "quantidade": 20,
            "entidade": "XXXXXX"
        }
    ],
    "CTE": [
        {
            "periodo": "JANEIRO/2024",
            "quantidade": 2,
            "entidade": "XXXXXX"
        },
        {
            "periodo": "FEVEREIRO/2024",
            "quantidade": 2,
            "entidade": "XXXXXX"
        }
    ]
}

Estrutura - JSON
Campo	Tipo	Estrutura pai	Descrição	Observação
status	Numérico	-	Código de status de retorno.	Sucesso: 200 Falha: 400
message	String	-	Indica se a requisição foi bem-sucedida.	Em caso de retorno positivo: "sucesso" Em caso de retorno negativo: Mensagem com a descrição do erro.
modelo	Vetor	-	Vetor contendo as informações de retorno da requisição conforme os modelos solicitado.	-
periodo	String	modelo	Retorna o mês e ano do período solicitado.	Retornado em caso de sucesso.
quantidade	String	modelo	Retorna a quantidade de documentos no período.	Retornado em caso de sucesso, podendo retornar com valor zerado caso não existir registro na CONSOLID02.
entidade/CNPJ	String	modelo	Retorna a entidade ou CNPJ utilizado no TSS.	Retorna em caso de sucesso, podendo retornar mensagem de erro caso CNPJ ou entidade não exista.

Retorno de sucesso possíveis
Descrição	Observação
Sucesso	Estrutura completa com os dados requeridos

Retorno de erro possíveis
Descrição	Observação
Erro na estrutura do JSON	Validar se a estrutura confere com o modelo esperado.
Nenhum dado encontrado com o filtro informado, verifique os filtros	Verifique os campos como: modelos, ANO, CNPJ e Entidade.
CNPJ ou Entidade não preenchidos.	Necessário informar ao menos uma entidade ou um CNPJ.
Dado incorreto: *campo, esperado caractere*	Dado informado no campo, foi diferente de string.
Estrutura incorreta parte faltante *campo*	Validar se todos os campos necessários foram informados na requisição.

03. TABELAS UTILIZADAS

SPED050, CONSOLID01, CONSOLID02, TSS0010.