Setfin Connect
DocumentaçãoAplicativo
DocumentaçãoAplicativo
Falar com suporte
  1. Impostos
  • Introdução
  • Autenticação
  • Empresa
    • Verificar CNPJ
      GET
    • Consultar Empresa
      GET
    • Criar Empresa
      POST
    • Atualizar Empresa
      PATCH
  • Impostos
    • Consultar Impostos
      GET
    • Consultar Imposto Individual
      GET
    • Criar Imposto
      POST
    • Emitir Guia de Pagamento
      POST
  • Dados Cadastrais
    • Consultar Dados PJ
      GET
    • Consultar Dados PF
      GET
    • Consultar Empresas no CPF
      GET
  • Certificado
    • Guia de integração
    • Consultar Certificado
      GET
    • Criar Certificado
      POST
    • Deletar Certificado
      DELETE
  • Nota Fiscal
    • Guia de integração
    • Nota de produto
      • Consultar Notas de Produto
      • Consultar uma Nota de Produto
      • Consultar Anexos de Nota de Produto
      • Emitir Nota de Produto
      • Cancelar Nota de Produto
    • Nota de serviço
      • Consultar Notas de Serviço
      • Consultar uma Nota de Serviço
      • Consultar Anexos de Nota de Serviço
      • Emitir Nota de Serviço
      • Cancelar Nota de Serviço
    • Consultar Status de Configuração
      GET
    • Configurar Emissão de Nota Fiscal
      POST
  • Serviços Municipais
    • Guia de integração
    • Consultar Status do Município
      GET
    • Consultar Serviços Municipais
      GET
  1. Impostos

Criar Imposto

POST
https://connect.setfin.com.br/v1/taxes/{company_id}
consultarimpostosindividual
Por meio deste endpoint, o parceiro pode criar um imposto para empresa.

Requisição

Parâmetros Path
company_id
string 
requerido
Identificador único da empresa.
Parâmetros Header
x-keep-cache
boolean 
opcional
Utilize 'true' quando desejar utilizar o cache salvo e 'false' para fazer uma nova busca na fonte de dados.
Authorization
string 
requerido
Token de autorização
Parâmetros Bodyapplication/json
period
string 
requerido
Perído (Ex: 022025)
kind
enum<string> 
requerido
Tipo
Valores permitidos:
DASINSSISS
Padrão:
'DAS'
situation
string 
requerido
Situação
Padrão:
'PENDING'
fine_amount
number 
opcional
Padrão:
0.0
fees_amount
number 
opcional
Padrão:
0.0
total_amount
number 
opcional
Valor total
Padrão:
0.0
due_date
string 
opcional
Data de vencimento
paid_date
string 
opcional
Data de pagamento
calculated_tax_date
string 
opcional
Data de apuração
icms_amount
number 
opcional
Valor do ICMS
Padrão:
0.0
iss_amount
number 
opcional
Valor do ISS
Padrão:
0.0
inss_amount
number 
opcional
Valor do INSS
Padrão:
0.0
irrf_amount
number 
opcional
Valor do IRRF
Padrão:
0.0
total_tax_amount
number 
opcional
Valor total
Padrão:
0.0
file
string 
opcional
Arquivo
reference_id
string 
opcional
Identificador de referência
line_code
string 
opcional
Código de barras
attachment_id
string 
opcional
Identificador único do anexo.
associate_id
string 
opcional
Identificador único do sócio.
Exemplo
{
    "period": "string",
    "kind": "'DAS'",
    "situation": "'PENDING'",
    "fine_amount": "0.0",
    "fees_amount": "0.0",
    "total_amount": "0.0",
    "due_date": "string",
    "paid_date": "string",
    "calculated_tax_date": "string",
    "icms_amount": "0.0",
    "iss_amount": "0.0",
    "inss_amount": "0.0",
    "irrf_amount": "0.0",
    "total_tax_amount": "0.0",
    "file": "string",
    "reference_id": "string",
    "line_code": "string",
    "attachment_id": "string",
    "associate_id": "string"
}

Exemplos de Requisição

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://connect.setfin.com.br/v1/taxes/' \
--header 'x-keep-cache;' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "period": "string",
    "kind": "'\''DAS'\''",
    "situation": "'\''PENDING'\''",
    "fine_amount": "0.0",
    "fees_amount": "0.0",
    "total_amount": "0.0",
    "due_date": "string",
    "paid_date": "string",
    "calculated_tax_date": "string",
    "icms_amount": "0.0",
    "iss_amount": "0.0",
    "inss_amount": "0.0",
    "irrf_amount": "0.0",
    "total_tax_amount": "0.0",
    "file": "string",
    "reference_id": "string",
    "line_code": "string",
    "attachment_id": "string",
    "associate_id": "string"
}'

Respostas

🟢200Sucesso
application/json
Body
id
string 
requerido
Identificador único.
period
string 
requerido
Perído (Ex: 022025)
amount
number 
requerido
Valor
Padrão:
0.0
fine_amount
number 
requerido
Padrão:
0.0
fees_amount
number 
requerido
Padrão:
0.0
total_amount
number 
requerido
Valor total
Padrão:
0.0
due_date
string 
opcional
Data de vencimento
paid_date
string 
opcional
Data de pagamento
calculated_tax_date
string 
opcional
Data de apuração
icms_amount
number 
requerido
Valor do ICMS
Padrão:
0.0
iss_amount
number 
requerido
Valor do ISS
Padrão:
0.0
inss_amount
number 
requerido
Valor do INSS
Padrão:
0.0
irrf_amount
number 
requerido
Valor do IRRF
Padrão:
0.0
total_tax_amount
number 
opcional
Valor total
Padrão:
0.0
file
string 
opcional
Arquivo
situation
string 
requerido
Situação
Padrão:
'PENDING'
reference_id
string 
opcional
Identificador de referência
line_code
string 
opcional
Código de barras
kind
enum<string> 
requerido
Tipo
Valores permitidos:
DASINSSISS
Padrão:
'DAS'
company_id
string 
requerido
Identificador único da empresa.
attachment_id
string 
opcional
Identificador único do anexo.
associate_id
string 
opcional
Identificador único do sócio.
bill_id
string 
opcional
Identificador único do lançamento.
Exemplo
{
    "id": "string",
    "period": "string",
    "amount": "0.0",
    "fine_amount": "0.0",
    "fees_amount": "0.0",
    "total_amount": "0.0",
    "due_date": "string",
    "paid_date": "string",
    "calculated_tax_date": "string",
    "icms_amount": "0.0",
    "iss_amount": "0.0",
    "inss_amount": "0.0",
    "irrf_amount": "0.0",
    "total_tax_amount": "0.0",
    "file": "string",
    "situation": "'PENDING'",
    "reference_id": "string",
    "line_code": "string",
    "kind": "'DAS'",
    "company_id": "string",
    "attachment_id": "string",
    "associate_id": "string",
    "bill_id": "string"
}
🟠404Empresa não encontrada
🟠404Imposto não encontrado
Página anterior
Consultar Imposto Individual
Próxima página
Emitir Guia de Pagamento
Built with