Tabla de contenidos
Si se han salteado algunas numeraciones del timbrado electrónico y ya no se van a utilizar más esas numeraciones entonces se pueden inutilizar esos números salteados, para indicar a la DNIT que esos números de documentos ya son inválidos fiscalmente.
Este servicio ejecuta la inutilización de uno o mas numeraciones del timbrado electrónico teniendo en cuenta el parámetro desde y hasta incluyendo los valores limites especificados.
No es necesario especificar el timbrado, pues esta información es extraída de Datos fiscales, de la Consola de Facturasend.
Endpoint (URL) #
POST https://api.facturasend.com.py/<tenantId>/evento/inutilizacion
Header (Encabezado) #
Requiere el envío del los siguientes atributos en el encabezado
| Campo | Valor |
|---|---|
| Authorization | Bearer api_key_reemplazar_api_key |
| Content-Type | application/json; charset=utf-8 |
Parámetros (BODY) #
{
"tipoDocumento": 1,
"establecimiento": `001`,
"punto": `001`,
"desde": 10,
"hasta": 12,
"motivo": `Se inutiliza la numeración por error de generación en software`
}
| Campo | Requerido | Valor |
|---|---|---|
| tipoDocumento | Si | Número entero que representa el Tipo de Documento Electrónico del 1 al 7 |
| establecimiento | Si | String conteniendo el valor del establecimiento que corresponde a la numeración que desea inutilizar |
| punto | Si | String conteniendo el valor del punto que corresponde a la numeración que desea inutilizar |
| desde | Si | Número inicial a partir del cual se deben inutilizar la numeración |
| hasta | Si | Número final hasta el cual se deben inutilizar la numeración |
| serie | No | Valor de la Serie del rango de números que se desean inutilizar |
| motivo | Si | El motivo por el cual desea inutilizar el rango de numeraciones |
Parámetros (Query Param) #
No posee
Ejemplo de llamadas #
# Inutiliza un rango de números de documentos
curl \
-X \
POST "https://api.facturasend.com.py/<tenantId>/evento/inutilizacion" \
-H "Authorization: Bearer api_key_<reemplazar_api_key>" \
-H 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
tipoDocumento: 1,
establecimiento: `001`,
punto: `001`,
desde: 10,
hasta: 12,
motivo: `Se inutiliza la numeración por error de generacion en software`
}'
# El ejemplo se muestra utilizando AXIOS
import axios from 'axios';
const headers = {
`Authorization` : `Bearer api_key_<reemplazar_api_key>`,
`Content-Type` : `application/json; charset=utf-8`
};
const data = {
tipoDocumento: 1,
establecimiento: `001`,
punto: `001`,
desde: 10,
hasta: 12,
motivo: `Se inutiliza la numeración por error de generacion en software`
};
axios.post({
url: `https://api.facturasend.com.py/<tenantId>/evento/inutilizacion`,
method: 'POST',
{headers}
}
).then( respuesta => {
console.log(respuesta);
});
Respuesta de la Petición #
La respuesta de la petición será la siguiente:
{
"success" : true,
"result" : {
"ns2:rRetEnviEventoDe" : {
"ns2:gResProcEVe" : "2022-02-08T14:39:00",
"ns2:gResProcEVe" : {
"ns2:dEstRes" : "Aprobado",
"ns2:gResProc" : {
"ns2:dCodRes" : "",
"ns2:dMsgRes" : ""
}
}
}
}
}
| Campo | Tipo | Valor |
|---|---|---|
| success | boolean | true si todo ocurrió bien y se inutilizaron las numeraciones del timbrado, false si ocurrió algún error |
| result | object | Objeto resultante de la operación del evento, directamente en el formato que devuelve el SIFEN |
Recomendaciones #
- No aplica
Validaciones #
- No aplica
