Árvore de páginas


01. DADOS GERAIS

Produto:

TOTVS Backoffice

Linha de Produto:

Linha Protheus 

Segmento:

Backoffice SP 

Módulo:AUTOMAÇÃO FISCAL
Função:backoffice.taf.mit.lookup
Ticket:Não há
Requisito/Story/Issue (informe o requisito relacionado) :DSERTAF2-20858

02. SITUAÇÃO/REQUISITO

Criar as duas API's de lookup para a forma de tributação e cadastro de contabilistas. 

03. SOLUÇÃO

As API's foram criadas e disponibilizadas com as seguintes funcionalidades:

API de Forma de Tributação

Objetivo:
Retornar às informações cadastrais das formas de tributação.

Funcionalidades:

  • Retorno de Dados:
    • id: Identificador único da forma de tributação.

    • período: Período de vigência da forma de tributação

  • Filtros Suportados:
    • Consulta por período, permitindo buscar formas de tributação por dia/mês e mês/ano
  • Exemplo de Requisição:


GET
/api/taf/fiscal/v1/TaxFormmit?companyId=
  • Exemplo de Resposta:
JSON
{
    "items": [
        {
            "id": "9e570be1-7e82-41b8-3fbe-9fcf711f2e74",
            "period": "01/01/2023 31/03/2023"
        },
        {
            "id": "f0eb8a13-f602-83cc-a3e6-15b3cde88f0e",
            "period": "07/09/2021 31/12/2021"
        },
        {
            "id": "35b71e04-4907-4e8b-1ec5-66ef53bbab54",
            "period": "01/01/2021 06/09/2021"
        },
        {
            "id": "0a48ff2e-cf7d-7559-a9c9-19587125f2d8",
            "period": "01/01/2020 31/12/2020"
        }
    ],
    "hasNext": false
}

API de Cadastro de Contabilistas

Objetivo:
Retornar os dados cadastrais de contabilistas.

Funcionalidades:

  • Retorno de Dados:
    • nome: Nome completo do contabilista.
    • CRC: Número de registro no Conselho Regional de Contabilidade.

  • Filtros Suportados:

    • nome: permitindo buscar contabilistas por parte ou todo o nome.

    • CRC: para localizar um contabilista específico pelo número do CRC

  • Exemplo de Requisição:

GET
/api/taf/fiscal/v1/Accountantsmit?companyId=
  • Exemplo de Resposta:
JSON
{
    "items": [
        {
            "id": "03ff105d-2df9-c9de-c5b7-53feb25e7a3e",
            "name": "TAFCTB01",
            "crc": "20250112345678"
        },
        {
            "id": "45f62646-22b9-07ba-293d-7ab9787a89d9",
            "name": "TAFCTB02",
            "crc": "12345202501123"
        }
    ],
    "hasNext": false
}


04. DEMAIS INFORMAÇÕES

TOTVS Automação Fiscal

05. ASSUNTOS RELACIONADOS

        Não se aplica