Emitir Nota de Serviço

POST

https://connect.setfin.com.br/v1/companies/{company_id}/service_nfe

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

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Path

Parâmetros Header

Parâmetros Bodyapplication/json

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
        }
    ]
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

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

Modificado em 2025-06-23 11:58:05

Página anterior

Consultar Anexos de Nota de Serviço

Próxima página

Cancelar Nota de Serviço