São Paulo

Documentação de São Paulo

POST /api/v1/nfse

Exemplo completo com tomador Pessoa Jurídica:

{
    "emitter_id": 2,
    "service_values": {
        "rps_situation": "T",
        "rps_type": "RPS",
        "serie": "TESTE",
        "service_item_code": "02879",
        "description": "Teste",
        "service_amount": 100.00,
        "iss_percentage": 5.0,
        "inss_percentage": 0.0,
        "ir_percentage": 0.0,
        "cofins_percentage": 0.0,
        "csll_percentage": 0.0,
        "pis_percentage": 0.0,
        "retained_iss": false,
        "retained_iss_percentage": 0.0,
        "tax_burden_percentage": 1.00,
        "tax_burden_amount": 1.00,
        "tax_burden_source": "IBPT",
        "highlight_retentions": ["ir_amount", "pis_amount", "cofins_amount", "csll_amount", "inss_amount", "retained_iss_amount"],
        "tax_burden_highlight": true
    },
    "taker": {
        "cnpj": "11023029000105",
        "social_reason": "Teste",
        "fancy_name": "Teste",
        "city_inscription": "39476901",
        "state_inscription": "",
        "special_situation": "",
        "foreign_taker": false,
        "address": {
            "zip_code": "95095000",
            "state": "RS",
            "city": "Caxias do Sul",
            "neighborhood": "CENTRO",
            "street": "Pinheiro Machado",
            "neighborhood_type": "",
            "number": "123",
            "street_type": "RUA",
            "complement": "",
            "reference_point": ""
        },
        "contact": {
            "email": "adriano.margarin@myfreecomm.com.br",
            "phone": "1234567890"
        }
    }
}

Exemplo completo com tomador Pessoa Física:

{
    "emitter_id": 1,
    "service_values": {
        "rps_situation": "T",
        "rps_type": "RPS",
        "serie": "TESTE",
        "service_item_code": "02879",
        "description": "Teste",
        "service_amount": 100.00,
        "iss_percentage": 5.0,
        "inss_percentage": 0.0,
        "ir_percentage": 0.0,
        "cofins_percentage": 0.0,
        "csll_percentage": 0.0,
        "pis_percentage": 0.0,
        "retained_iss": false,
        "retained_iss_percentage": 0.0,
        "tax_burden_percentage": 1.00,
        "tax_burden_amount": 1.00,
        "tax_burden_source": "IBPT",
        "highlight_retentions": ["ir_amount", "pis_amount", "cofins_amount", "csll_amount", "inss_amount", "retained_iss_amount"],
        "tax_burden_highlight": true
    },
    "taker": {
        "cpf": "11185827641",
        "social_reason": "Fulano de tal",
        "address": {
            "zip_code": "95095000",
            "state": "RS",
            "city": "Caxias do Sul",
            "neighborhood": "CENTRO",
            "street": "Pinheiro Machado",
            "neighborhood_type": "",
            "number": "123",
            "street_type": "RUA",
            "complement": "",
            "reference_point": ""
        },
        "contact": {
            "email": "fulado.tal@exemplo.com.br",
            "phone": "1234567890"
        }
    }
}

Dados gerais da nota

Parâmetro Descrição Formato Obrigatório
emitter_id Identificação do emitente cadastrado no Emites.   Sim

Dados do service_values

Parâmetro Descrição Formato Obrigatório
rps_situation Situação da NFSe. *Ver valores permitidos.   Sim
rps_type Tipo do RPS. *Ver valores permitidos.   Sim
serie Série do RPS.   Sim
service_item_code Código do serviço conforme prefeitura onde o serviço é prestado.   Sim
description Discriminação dos serviços.   Sim
service_amount Valor do Serviço em R$. 0.00 Sim
deduction_amount Valor das deduções para Redução da Base de Cálculo em R$. 0.00 Não
iss_percentage Valor do ISS em %. 0.00 Não
inss_percentage Valor do INSS em %. 0.00 Não
ir_percentage Valor do IR em %. 0.00 Não
cofins_percentage Valor do COFINS em %. 0.00 Não
csll_percentage Valor do CSLL em %. 0.00 Não
pis_percentage Valor do PIS em %. 0.00 Não
retained_iss_percentage Valor do ISS retirdo em %. 0.00 Não

Valores permitidos para rps_situation

Valor Descrição
T Tributado em São Paulo
F Tributado Fora de São Paulo
A Tributado em São Paulo, porém Isento
B Tributado Fora de São Paulo, porém Isento
M Tributado em São Paulo, porém Imune
N Tributado Fora de São Paulo, porém Imune
X Tributado em São Paulo, porém Exigibilidade Suspensa
V Tributado Fora de São Paulo, porém Exigibilidade Suspensa
P Exportação de Serviços
C Cancelado

Valores permitidos para rps_type

Valor Descrição
RPS RPS
RPS-M RPS-M
RPS-C RPS-C

Dados do taker

Parâmetro Descrição Formato Obrigatório
cpf CPF do tomador.   Sim*
cnpj CNPJ do tomador.   Sim**
social_reason Razão Social do Tomador.   Sim
fancy_name Nome Fantasia do Tomador.   Não
city_inscription Inscrição Municipal do Tomador.   Não
state_inscription Inscrição Estadual do Tomador.   Não
special_situation Situação Especial do Tomador. *Ver valores permitidos.   Não
foreign_taker Tomador Estrangeiro. true ou false Não

*cpf: Não obrigatório caso seja passado o cnpj.

**cnpj: Não obrigatório caso seja passado o cpf.

Valores permitidos para special_situation

Valor Descrição
0 Outros
1 SUS
2 Órgão do Poder Executivo
3 Bancos
4 Comércio/Industria
5 Poder Legislativo/Judiciário

Endereço do tomador:

Parâmetro Descrição Obrigatório
zip_code CEP. Não
state Estado (Sigla). Sim
city Nome da cidade. Sim
neighborhood Bairro. Não
street Logradouro. Não
neighborhood_type Tipo do logradouro. *Ver valores permitidos. Não
number Número. Não
street_type Tipo do bairro. *Ver valores permitidos. Não
complement Complemento do endereço. Não
reference_point Ponto de referência. Não

Valores permitidos para street_type

Valor Descrição
RUA Rua
ALM Alameda
AVN Avenida
BEC Beco
BLV Boulevard
CAM Caminho
CAS Cais
CMP Campo
ESC Escada
ETR Estrada
FAV Favela
FAZ Fazendo
FLT Floresta
ILH Ilha
JRD Jardim
LAD Ladeira
LRG Largo
LTM Loteamento
LUG Lugar
MRR Morro
PQE Parque
PAS Passeio
PRA Praia
PRC Praça
REC Recanto
ROD Rodovia
SRV Servidão
TRV Travessa
VIA Via
VIL Vila

Valores permitidos para neighborhood_type

Valor Descrição
IND Industrial
COM Comercial
RED Residencial

Contato do tomador:

Parâmetro Descrição Obrigatório
email Telefone do tomador, com o código DDD. Não
phone Email do tomador. Não