Skip to main content
GET
/
notas
/
{idNota}
Obter nota fiscal
curl --request GET \
  --url https://api.tiny.com.br/public-api/v3/notas/{idNota} \
  --header 'Authorization: Bearer <token>'
{
  "situacao": 1,
  "tipo": "E",
  "numero": "<string>",
  "serie": "<string>",
  "chaveAcesso": "<string>",
  "dataEmissao": "<string>",
  "dataPrevista": "<string>",
  "cliente": {
    "nome": "<string>",
    "codigo": "<string>",
    "fantasia": "<string>",
    "tipoPessoa": "J",
    "cpfCnpj": "<string>",
    "inscricaoEstadual": "<string>",
    "rg": "<string>",
    "telefone": "<string>",
    "celular": "<string>",
    "email": "<string>",
    "endereco": {
      "endereco": "<string>",
      "numero": "<string>",
      "complemento": "<string>",
      "bairro": "<string>",
      "municipio": "<string>",
      "cep": "<string>",
      "uf": "<string>",
      "pais": "<string>"
    },
    "id": 123
  },
  "enderecoEntrega": {
    "endereco": "<string>",
    "numero": "<string>",
    "complemento": "<string>",
    "bairro": "<string>",
    "municipio": "<string>",
    "cep": "<string>",
    "uf": "<string>",
    "pais": "<string>",
    "nomeDestinatario": "<string>",
    "cpfCnpj": "<string>",
    "tipoPessoa": "<string>",
    "telefone": "<string>",
    "inscricaoEstadual": "<string>"
  },
  "valor": 123,
  "valorProdutos": 123,
  "valorFrete": 123,
  "vendedor": {
    "id": 123,
    "nome": "<string>"
  },
  "idFormaEnvio": 123,
  "idFormaFrete": 123,
  "codigoRastreamento": "<string>",
  "urlRastreamento": "<string>",
  "fretePorConta": "<string>",
  "qtdVolumes": 123,
  "pesoBruto": 123,
  "pesoLiquido": 123,
  "id": 123,
  "finalidade": 1,
  "regimeTributario": 1,
  "dataInclusao": "<string>",
  "baseIcms": 123,
  "valorIcms": 123,
  "baseIcmsSt": 123,
  "valorIcmsSt": 123,
  "valorServicos": 123,
  "valorSeguro": 123,
  "valorOutras": 123,
  "valorIpi": 123,
  "valorIssqn": 123,
  "valorDesconto": 123,
  "valorFaturado": 123,
  "idIntermediador": 123,
  "idNaturezaOperacao": 123,
  "idFormaPagamento": 123,
  "idMeioPagamento": 123,
  "observacoes": "<string>",
  "condicaoPagamento": "<string>",
  "valorNotaComImpostos": 123,
  "valorBaseDiferimento": 123,
  "percentualICMSPartilhaDestino": 123,
  "valorTotalICMSFCPDestino": 123,
  "valorIPIDevolvido": 123,
  "tipoNotaCredito": "<string>",
  "tipoNotaDebito": "<string>",
  "valorTotalBCIBSCBS": 123,
  "valorTotalIBSUF": 123,
  "valorTotalCBS": 123,
  "itens": [
    {
      "idItem": 123,
      "idProduto": 123,
      "codigo": "<string>",
      "ncm": "<string>",
      "descricao": "<string>",
      "unidade": "<string>",
      "quantidade": 123,
      "valorUnitario": 123,
      "valorTotal": 123,
      "cfop": "<string>",
      "naturezaOperacao": "<string>"
    }
  ],
  "parcelas": [
    {
      "dias": 123,
      "data": "<string>",
      "valor": 123,
      "observacoes": "<string>",
      "idFormaPagamento": "<string>",
      "idMeioPagamento": "<string>"
    }
  ],
  "pagamentosIntegrados": [
    {
      "valor": 123,
      "tipoPagamento": 123,
      "cnpjIntermediador": "<string>",
      "codigoAutorizacao": "<string>",
      "codigoBandeira": 123
    }
  ],
  "ecommerce": {
    "id": 123,
    "nome": "<string>",
    "numeroPedidoEcommerce": "<string>",
    "numeroPedidoCanalVenda": "<string>",
    "canalVenda": "<string>"
  },
  "marcadores": [
    {
      "descricao": "<string>",
      "cor": "<string>"
    }
  ],
  "transportador": {
    "nome": "<string>",
    "cpfCnpj": "<string>",
    "ie": "<string>",
    "endereco": "<string>",
    "municipio": "<string>",
    "uf": "<string>"
  },
  "origem": {
    "id": "<string>",
    "tipo": "pedido_compra"
  }
}

Path Parameters

idNota
integer
required

Identificador da nota fiscal

Response

OK

situacao
enum<string> | null
  • 1 - Pendente
  • 2 - Emitida
  • 3 - Cancelada
  • 4 - Enviada Aguardando Recibo
  • 5 - Rejeitada
  • 6 - Autorizada
  • 7 - Emitida Danfe
  • 8 - Registrada
  • 9 - Enviada Aguardando Protocolo
  • 10 - Denegada
Available options:
1,
2,
3,
4,
5,
6,
7,
8,
9,
10
tipo
enum<string> | null
  • E - Entrada
  • S - Saida
Available options:
E,
S
numero
string | null
serie
string | null
chaveAcesso
string | null
dataEmissao
string | null
dataPrevista
string | null
cliente
· object
enderecoEntrega
· object
valor
number<float> | null
valorProdutos
number<float> | null
valorFrete
number<float> | null
vendedor
· object
idFormaEnvio
integer | null
idFormaFrete
integer | null
codigoRastreamento
string | null
urlRastreamento
string | null
fretePorConta
string | null
qtdVolumes
integer | null
pesoBruto
number<float> | null
pesoLiquido
number<float> | null
id
integer
finalidade
enum<string> | null
  • 1 - Nfe Normal
  • 2 - Nfe Complementar
  • 3 - Nfe Ajuste
  • 4 - Devolucao Retorno
  • 5 - Credito
  • 6 - Debito
  • 7 - Nfe Cupom Referenciado
  • 8 - Devolucao Retorno Sem Nfe
  • 9 - Nfe Chave Acesso Referenciada
Available options:
1,
2,
3,
4,
5,
6,
7,
8,
9
regimeTributario
enum<integer> | null
  • 1 - Simples Nacional
  • 2 - Simples Nacional Excesso Receita
  • 3 - Regime Normal
  • 4 - Mei
Available options:
1,
2,
3,
4
dataInclusao
string | null
baseIcms
number<float> | null
valorIcms
number<float> | null
baseIcmsSt
number<float> | null
valorIcmsSt
number<float> | null
valorServicos
number<float> | null
valorSeguro
number<float> | null
valorOutras
number<float> | null
valorIpi
number<float> | null
valorIssqn
number<float> | null
valorDesconto
number<float> | null
valorFaturado
number<float> | null
idIntermediador
integer | null
idNaturezaOperacao
integer | null
idFormaPagamento
integer | null
idMeioPagamento
integer | null
observacoes
string | null
condicaoPagamento
string | null
valorNotaComImpostos
number<float>
valorBaseDiferimento
number<float> | null
percentualICMSPartilhaDestino
number<float> | null
valorTotalICMSFCPDestino
number<float> | null
valorIPIDevolvido
number<float> | null
tipoNotaCredito
string | null
tipoNotaDebito
string | null
valorTotalBCIBSCBS
number<float> | null
valorTotalIBSUF
number<float> | null
valorTotalCBS
number<float> | null
itens
· object[]
parcelas
· object[]
pagamentosIntegrados
NotaFiscalPagamentoIntegradoModelResponse · object[]
ecommerce
· object
marcadores
· object[] | null
transportador
· object
origem
· object