Setfin Connect
DocumentaçãoAplicativo
DocumentaçãoAplicativo
Falar com suporte
  1. Nota de produto
  • 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
        GET
      • Consultar uma Nota de Produto
        GET
      • Consultar Anexos de Nota de Produto
        GET
      • Emitir Nota de Produto
        POST
      • Cancelar Nota de Produto
        DELETE
    • 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
    • Consultar Serviços Municipais
  1. Nota de produto

Emitir Nota de Produto

POST
https://connect.setfin.com.br/v1/product_invoices
nota fiscalemitirnfenota de produto
Por meio deste endpoint, o parceiro pode emitir uma de nota produto.

Requisição

Parâmetros Header
Authorization
string 
requerido
Token de autorização
Parâmetros Bodyapplication/json
operation
enum<string> 
requerido
Tipo da operação.
Valores permitidos:
CREDITDEBIT
nature_operation
string 
requerido
Natureza da operação.
company_id
string 
requerido
Identificador único da empresa.
borrower
object (Borrower) 
requerido
Tomador
document_number
enum<string> 
requerido
CPF ou CNPJ
Valores permitidos:
serviceproduct
name
string 
requerido
Nome ou Razão Social
email
string 
requerido
E-mail
state_tax_number
string 
requerido
Inscrição Estadual
phone_number
string 
requerido
Telefone
type
enum<string> 
requerido
Tipo do tomador
Valores permitidos:
LEGALNATURAL
address
object (Address) 
requerido
Endereço
invoice_order
object 
requerido
Pedido da nota
operation_type
enum<string> 
requerido
Modalidade da operação
Valores permitidos:
NOT_APPLICABLEIN_PERSONONLINEREMOTE_SUPPORTDELIVERY_NFCEIN_PERSON_OFFSITEOTHER_REMOTE
shipping_mode
enum<string> 
requerido
Tipo de frete
Valores permitidos:
SENDER_PAYS_CIFRECIPIENT_PAYS_FOBTHIRD_PARTY_PAYSOWN_TRANSPORT_SENDEROWN_TRANSPORT_RECIPIENTNO_TRANSPORT_OCCURRENCE
discount_amount_cents
integer 
requerido
Valor do desconto
>= -2147483648<= 2147483647
total_amount_cents
integer 
requerido
Valor total do pedido
>= -2147483648<= 2147483647
shipping_amount_cents
integer 
opcional
Valor do frete
>= -2147483648<= 2147483647
invoice_products
array [object {6}] 
requerido
product_id
string 
requerido
ID do produto
amount
integer 
requerido
Quantidade
>= -2147483648<= 2147483647
total_amount_cents
integer 
requerido
Valor total
>= -2147483648<= 2147483647
subtotal_amount_cents
integer 
requerido
Sub-total
>= -2147483648<= 2147483647
origin
string 
requerido
Origem do produto
discount_amount_cents
integer 
opcional
Valor do desconto
>= -2147483648<= 2147483647
payment
object 
requerido
kind
enum<string> 
requerido
Tipo do pagamento
Valores permitidos:
INSTALLMENTSCASH
amount_cents
array[string]
opcional
Valores do pagamento
payment_method
array[string]
opcional
Meios de pagamento
Exemplo
{
    "amount_cents": 79979,
    "company_id": "uuid da empresa",
    "borrower": {
        "document_number": "12312312312",
        "name": "John Doe",
        "email": "johndoe@example.com",
        "state_tax_number": "12345678",
        "phone_number": "99999999999",
        "type": "NATURAL",
        "address": {
            "postal_code": "0000000",
            "district": "Logradouro",
            "district_type": "Rua",
            "city": "São Paulo",
            "city_code": "3550308",
            "state": "SP",
            "neighborhood": "Bairro",
            "number": "60",
            "additional_information": "Andar 7"
        }
    },
    "service_code": "17.02",
    "additional_information": "Serviço prestado em 02/2025",
    "tax_class": "REF...",
    "taxes": [
        {
            "kind": "iss",
            "rate": 0.2
        },
        {
            "kind": "cofins",
            "rate": 0.4
        },
        {
            "kind": "iss",
            "rate": 0.2
        }
    ]
}

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/product_invoices' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount_cents": 79979,
    "company_id": "uuid da empresa",
    "borrower": {
        "document_number": "12312312312",
        "name": "John Doe",
        "email": "johndoe@example.com",
        "state_tax_number": "12345678",
        "phone_number": "99999999999",
        "type": "NATURAL",
        "address": {
            "postal_code": "0000000",
            "district": "Logradouro",
            "district_type": "Rua",
            "city": "São Paulo",
            "city_code": "3550308",
            "state": "SP",
            "neighborhood": "Bairro",
            "number": "60",
            "additional_information": "Andar 7"
        }
    },
    "service_code": "17.02",
    "additional_information": "Serviço prestado em 02/2025",
    "tax_class": "REF...",
    "taxes": [
        {
            "kind": "iss",
            "rate": 0.2
        },
        {
            "kind": "cofins",
            "rate": 0.4
        },
        {
            "kind": "iss",
            "rate": 0.2
        }
    ]
}'

Respostas

🟢200Sucesso
application/json
Body
id
string 
requerido
Identificador único
number
integer 
requerido
Número de controle (sequencial)
Padrão:
0
reference_id
string 
requerido
Identificador único da referência
company_id
string 
requerido
Identificador único da empresa
borrower_id
string 
requerido
Identificador único do tomador
borrower
object (Borrower) 
requerido
Tomador
document_number
enum<string> 
requerido
CPF ou CNPJ
Valores permitidos:
serviceproduct
name
string 
requerido
Nome ou Razão Social
email
string 
requerido
E-mail
state_tax_number
string 
requerido
Inscrição Estadual
phone_number
string 
requerido
Telefone
type
enum<string> 
requerido
Tipo do tomador
Valores permitidos:
LEGALNATURAL
address
object (Address) 
requerido
Endereço
status
enum<string> 
requerido
Valores permitidos:
ISSUEDPROCESSINGCANCELLINGCANCELLEDREJECTED
invoice_order_id
string 
requerido
Identificador único do pedido
finality
string 
requerido
Finalidade
cancelled_at
string 
opcional
Data de cancelamento
issued_at
string 
opcional
Data de emissão
invoice_payment_id
string 
opcional
Identificador único do invoice payment
reason
string 
opcional
Motivo da rejeição
reference_number
string 
opcional
Número da nota
Exemplo
{
    "id": "string",
    "number": "0",
    "reference_id": "string",
    "company_id": "string",
    "borrower_id": "string",
    "borrower": {
        "document_number": "service",
        "name": "string",
        "email": "string",
        "state_tax_number": "string",
        "phone_number": "string",
        "type": "LEGAL",
        "address": {
            "postal_code": "string",
            "district": "string",
            "district_type": "string",
            "city": "string",
            "city_code": "string",
            "state": "string",
            "neighborhood": "string",
            "number": "string",
            "additional_information": "string"
        }
    },
    "status": "ISSUED",
    "invoice_order_id": "string",
    "finality": "string",
    "cancelled_at": "string",
    "issued_at": "string",
    "invoice_payment_id": "string",
    "reason": "string",
    "reference_number": "string"
}
🟠404Empresa não encontrada
🟠401Nota sem autorização
🟠422Inscrição estadual pendente
🟠404Produto não encontrado
🟠404Classe de imposto não encontrada
🟠400Erro desconhecido
Página anterior
Consultar Anexos de Nota de Produto
Próxima página
Cancelar Nota de Produto
Built with