Através deste endpoint é possível definir o lote à ser usado nas emissões de NFSe. O lote é uma informação essencial que deve ser incremental, logo é preciso uma definição inicial para evitar erros.
URL
Produção: POST https://nfseapi.ns.eti.br/v1/nfse/definirlote
Dados de entrada
| Campo | Descrição | Tipo | Tamanho | Ocorrência | Observação |
|---|---|---|---|---|---|
| X-AUTH-TOKEN | Token de acesso do usuário | String | 1-1 | Pode ser enviado no Header | |
| CNPJ | CNPJ do emitente da NFS-e | String | 14 | 1-1 | |
| lote | Número inicial de lote a ser utilizado | Inteiro | 1-1 |
Exemplo de requisição
Requisição de Lista de nsNRecs
curl -X POST
\-H "Content-Type: application/json"
\-H "X-AUTH-TOKEN: SEU_TOKEN"
\-d '{"lote": 2,"CNPJ": "99999999999999"}'
https://nfseapi.ns.eti.br/v1/nfse/definirlote
Dados retornados
| Campo | Descrição | Tipo | Ocorrência | Pai | Observação |
|---|---|---|---|---|---|
| status | Código de status do processamento | Inteiro | 1-1 | ||
| motivo | Descrição literal do status de processamento | String | 1-1 | ||
| erro | Objeto contendo os dados do erro | Objeto | 0-1 | Apenas quando status != 200 | |
| cStat | Código de status | Inteiro | 1-1 | erro | |
| xMotivo | Descrição literal | String | 1-1 | erro |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "Lote definido com sucesso"
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Consulta realizada com sucesso |
| -6 | Não foi possível realizar a operação. Verifique o objeto erro para mais informações |