Como realizar o upload de arquivos
Nesta seção, serão apresentadas duas maneiras de realizar o upload na API.
Upload arquivos [Multipart]
Realiza upload de arquivos retornando o identificador (id) do processo
Request
curl -X POST \
https://file.asisprojetos.com.br/api/v1/upload \
-H 'account-key: 4e07408562bedb8b60ce05c1decfe3ad16b72230967de01f640b7e' \
-H 'app-key: 6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb' \
-F 'file=@path/to/file/sped_fiscal.txt
Response
{"processos":[
{
"id":22362,
"nome":"sped_fiscal.txt",
"dataHoraCriacao":"06-06-2018 12:34:46",
"arquivoId":22740
}
]}
Upload arquivos [Base64]
*Recomendado apenas para arquivos pequenos de até 1mb
Realiza upload de arquivos retornando o identificador (id) do processo
Request
curl -X POST \
https://file.asisprojetos.com.br/api/v1/upload/base64?nome=arquivo.txt \
-H 'account-key: 4e07408562bedb8b60ce05c1decfe3ad16b72230967de01f640b7e' \
-H 'app-key: 6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb' \
-D 'ICAgICAxCWxlbwo=...'
Response
{"processos":[
{
"id":22362,
"nome":"sped_fiscal.txt",
"dataHoraCriacao":"06-06-2018 12:34:46",
"arquivoId":22740
}
]}
Upload de NFEs [JSON]
A API de Upload de notas fiscais permite que os usuários enviem NFEs em formato JSON para o servidor em https://xml.asisprojetos.com.br/api/v1/upload/json. Esta documentação fornece detalhes sobre como utilizar essa API.
Base URL
A URL base para esta API é https://xml.asisprojetos.com.br/api/v1/upload/json.
Authentication
Esta API requer autenticação por meio de cabeçalhos de solicitação.
Request Headers
- app-key (string, obrigatório): chave de aplicativo para autenticação.
- account-key (string, obrigatório): chave de conta para autenticação.
- Content-Type: application/json
Endpoint
Enviando uma NFE
- URL: /api/v1/upload/json
- Método HTTP: POST
- Corpo da requisição: Verificar em Example Request
Request
Para enviar uma NFE, faça uma solicitação POST para o endpoint /api/v1/upload/json com o json como parte do corpo da requisição. Enviar o parâmetro nome como parâmetro na url, contendo o nome do arquivo. Extensões suportadas: .json, .txt ou sem extensão.
Request Headers
- app-key: [Sua Chave de Aplicativo]
- account-key: [Sua Chave de Conta]
- Content-Type: application/json
Exemplo de Requisição
curl -L 'https://xml.asisprojetos.com.br/api/v1/upload/json?nome=arquivo.json ' \
-H 'app-key: 4e07408562bedb8b60ce05c1decfe3ad16b72230967de01f640b7e' \
-H 'account-key: b601b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52dcd' \
-H 'Content-Type: application/json' \
--data-raw '{
"NFe": {
"infNFe": {
"ide": {
"cUF": "99",
"cNF": "12345678",
"natOp": "VENDAS",
"mod": "99",
"serie": "999",
"nNF": "999999",
"dhEmi": "2023-09-29T09:30:00-03:00",
"dhSaiEnt": "2023-09-29T16:30:00-03:00",
"tpNF": "1",
"idDest": "1",
"cMunFG": "9999999",
"tpImp": "4",
"tpEmis": "9",
"cDV": "9",
"tpAmb": "2",
"finNFe": "4",
"indFinal": "1",
"indPres": "0",
"indIntermed": "1",
"procEmi": "3",
"verProc": "9.99.9"
},
"emit": {
"CNPJ": "12345678901234",
"xNome": "EMPRESA LTDA",
"xFant": "FICTICIA",
"enderEmit": {
"xLgr": "LOGRADOURO",
"nro": "1234",
"xBairro": "BAIRRO",
"cMun": "9999999",
"xMun": "CIDADE",
"UF": "SP",
"CEP": "99999999",
"cPais": "9999",
"xPais": "PAÍS",
"fone": "9999999999"
},
"IE": "123456789",
"IM": "1234567",
"CNAE": "1234567",
"CRT": "3"
},
"dest": {
"CNPJ": "98765432109876",
"xNome": "CLIENTE LTDA",
"enderDest": {
"xLgr": "LOGRADOURO",
"nro": "567",
"xBairro": "BAIRRO CLIENTE",
"cMun": "8888888",
"xMun": "CIDADE CLIENTE",
"UF": "YY",
"CEP": "88888888",
"cPais": "8888",
"xPais": "PAÍS CLIENTE",
"fone": "8888888888"
},
"indIEDest": "2",
"IE": "123456789",
"email": "EMAIL@CLIENTE.COM.BR"
},
"det": [
{
"prod": {
"cProd": "PRODUTO-123",
"cEAN": "12345678901234",
"xProd": "PRODUTO FICTÍCIO",
"NCM": "99999999",
"CEST": "9999999",
"CFOP": "5102",
"uCom": "UN",
"qCom": "99.999",
"vUnCom": "99.99",
"vProd": "9999.99",
"cEANTrib": "12345678901234",
"uTrib": "UN",
"qTrib": "99.999",
"vUnTrib": "99.99",
"indTot": "1",
"xPed": "PEDIDO-999",
"nItemPed": "999"
},
"imposto": {
"ICMS": {
"ICMS10": {
"orig": "0",
"CST": "10",
"modBC": "3",
"vBC": "9999.99",
"pICMS": "7.00",
"vICMS": "699.99",
"modBCST": "4",
"pMVAST": "52.14",
"vBCST": "9999.99",
"pICMSST": "17.00",
"vICMSST": "999.99"
}
},
"IPI": {
"cEnq": "999",
"IPITrib": {
"CST": "50",
"vBC": "9999.99",
"pIPI": "6.50",
"vIPI": "649.99"
}
},
"PIS": {
"PISAliq": {
"CST": "01",
"vBC": "9999.99",
"pPIS": "1.65",
"vPIS": "164.99"
}
},
"COFINS": {
"COFINSAliq": {
"CST": "01",
"vBC": "9999.99",
"pCOFINS": "7.60",
"vCOFINS": "759.99"
}
}
},
"infAdProd": "INFORMAÇÕES ADICIONAIS DO PRODUTO"
}
],
"total": {
"ICMSTot": {
"vBC": "9999.99",
"vICMS": "699.99",
"vICMSDeson": "0.00",
"vFCP": "0.00",
"vBCST": "9999.99",
"vST": "999.99",
"vFCPST": "0.00",
"vFCPSTRet": "0.00",
"vProd": "9999.99",
"vFrete": "0.00",
"vSeg": "0.00",
"vDesc": "0.00",
"vII": "0.00",
"vIPI": "649.99",
"vIPIDevol": "0.00",
"vPIS": "164.99",
"vCOFINS": "759.99",
"vOutro": "0.00",
"vNF": "9999.99"
}
},
"transp": {
"modFrete": "9",
"transporta": {
"CNPJ": "98765432109876",
"xNome": "TRANSPORTADORA FICTÍCIA LTDA",
"IE": "123456789",
"xEnder": "RUA TRANSPORTADORA FICTÍCIA, 1234 - BAIRRO TRANSPORTE",
"xMun": "CIDADE TRANSPORTADORA",
"UF": "XX"
},
"vol": {
"qVol": "99",
"esp": "CAIXA",
"pesoL": "999.999",
"pesoB": "999.999"
}
},
"cobr": {
"fat": {
"nFat": "12345",
"vOrig": "9999.99",
"vDesc": "0.00",
"vLiq": "9999.99"
},
"dup": [
{
"nDup": "0001",
"dVenc": "2023-12-31",
"vDup": "3333.33"
},
{
"nDup": "0002",
"dVenc": "2024-01-31",
"vDup": "3333.33"
},
{
"nDup": "0003",
"dVenc": "2024-02-29",
"vDup": "3333.33"
}
]
},
"pag": {
"detPag": {
"tPag": "99",
"vPag": "9999.99"
}
},
"infAdic": {
"infCpl": "INFORMAÇÕES ADICIONAIS"
},
"compra": null,
"infRespTec": {
"CNPJ": "98765432109876",
"xContato": "RESPONSÁVEL FICTÍCIO",
"email": "responsavel@ficticia.com.br",
"fone": "9999999999"
}
}
},
"protNFe": {
"infProt": {
"tpAmb": "2",
"verAplic": "FICTICIA_NFE_PL001_V1",
"chNFe": "99999999999999999999999999999999999999999999",
"dhRecbto": "2023-09-29T10:00:00-03:00",
"nProt": "123456789012345",
"digVal": "FICTICIA_DIGVAL",
"cStat": "100",
"xMotivo": "Autorizado o uso da NF-e"
}
}
}
'
Exemplo de Resposta
{
"processos": [
{
"id": 144,
"dataHoraCriacao": "29-09-2023 10:59:11",
"arquivoId": 1265
}
]
}
Próximas etapas
A próxima sessão, você poderá explorar mais sobre Geração de Cruzamento com a Asis API.