discardDraft()

Elimina un borrador editable. No es una cancelación fiscal.

Permiso: invoice:write

discardDraft(
  id: string,
  options?: RequestOptions
): Promise<{ id: string }>

Referencia HTTP: DELETE /invoice-drafts/{id}

• Devuelve únicamente el ID eliminado. Para un documento emitido utiliza cancelInvoice().

Parámetros

Argumento	Tipo	Obligatorio	Uso
id	string	Sí	ID de FactuCat del borrador, en formato UUID. No es el UUID fiscal.
options	RequestOptions	No	signal e idempotencyKey; consulta las opciones por solicitud.

Opciones por solicitud: signal e idempotencyKey.

Ejemplo

Usa el cliente factucat de Instala y conecta. Los IDs y datos fiscales de este ejemplo son ilustrativos: reemplázalos por los registros de tu cuenta y ambiente.

const resultado = await factucat.discardDraft(
  "00112233-4455-4677-8899-aabbccddeeff",
)
console.log(resultado)

Respuesta

Resuelve una Promise<{ id: string }>. El valor recibido es directamente data, sin el envoltorio HTTP ni sus metadatos.

Campo	Tipo	Obligatorio	Descripción
id	string	Sí	ID de FactuCat del recurso. No es el UUID fiscal.Formato: uuid

Ejemplo de respuesta

{
  "id": "00112233-4455-4677-8899-aabbccddeeff"
}

Las fechas se entregan como cadenas ISO 8601. Un campo opcional puede estar ausente. Tipos, paginación y archivos.

La promesa se rechaza si la API devuelve un error, falla la conexión o los datos no cumplen el contrato. Cómo manejar los errores.