Setfin Connect

Emitir Nota de Serviço

POST

https://connect.setfin.com.br/v1/service_invoices

nota fiscalnfseemitirnota de serviço

Por meio deste endpoint, o parceiro pode emitir uma de nota serviço.

Requisição

Parâmetros Header

Authorization

string

requerido

Token de autorização

Parâmetros Bodyapplication/json

amount_cents

number

requerido

Valor

company_id

string

requerido

Identificador único da empresa.

borrower

object (Borrower)

opcional

Tomador

document_number

enum<string>

requerido

CPF ou CNPJ

Valores permitidos:

serviceproduct

name

string

requerido

Nome ou Razão Social

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

service_code

string

requerido

Código de serviço

additional_information

string

requerido

Informações adicionais

tax_class

string

opcional

Classe de imposto

taxes

array [object {2}]

opcional

Impostos

kind

enum<string>

requerido

Tipo

Valores permitidos:

issinsscofinspiscsll

rate

integer

requerido

Alíquota

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://connect.setfin.com.br/v1/service_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

string

requerido

reference_id

string

requerido

ID de referência

number

requerido

Número de controle (sequencial)

municipal_service_id

string

requerido

ID do serviço municipal

status

enum<string>

requerido

Status da nota

Valores permitidos:

ISSUEDCANCELLEDPROCESSINGREJECTEDCANCELLING

amount_cents

integer

requerido

Valor da nota

borrower_id

string

requerido

borrower

object (Borrower)

requerido

Tomador da nota

document_number

enum<string>

requerido

CPF ou CNPJ

Valores permitidos:

serviceproduct

name

string

requerido

Nome ou Razão Social

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

reference_number

string

opcional

Número da nota

issued_at

string

opcional

Data da emissão

cancelled_at

string

opcional

Data de cancelamento

reason

string

opcional

Motivo da rejeição

additional_information

string

opcional

Informações adicionais

Exemplo

{
    "id": "string",
    "reference_id": "string",
    "number": 0,
    "municipal_service_id": "string",
    "status": "ISSUED",
    "amount_cents": 0,
    "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"
        }
    },
    "reference_number": "string",
    "issued_at": "string",
    "cancelled_at": "string",
    "reason": "string",
    "additional_information": "string"
}

🟠404Empresa não encontrada

🟠401Nota sem autorização

🟠422Endereço pendente

🟠422Inscrição municipal pendente

🟠422Endereço tomador pendente

🟠400Erro desconhecido

Página anterior

Consultar Anexos de Nota de Serviço

Próxima página

Cancelar Nota de Serviço