Eliminar empresa

Elimina la empresa de la cuenta. Solo si no tiene movimiento en producción.

Autenticación: token Bearer de cuenta (empresas:manage).

Consideraciones

Solo se puede eliminar una empresa sin movimiento en producción (sin comprobantes ni resúmenes emitidos o enviados en producción). Si lo tiene, responde 422.
Al eliminar se libera su certificado (sin estrenar), se limpian sus datos demo y se revocan sus tokens de firma.
Acción irreversible.

DELETEhttps://api.xmlperu.dev/v1/companies/{ruc}Copiar

Headers

Name	Type	Description
Accept	string	application/json
Content-Type	string	application/json
Authorization	string	Bearer <token>. Genéralo desde tu panel, en `Tokens de API`.

Parámetros de URL

Name	Type	Description
ruc*	string	RUC de 11 dígitos de la empresa a eliminar.

Ejemplo de solicitud

Copiar

curl -X DELETE https://api.xmlperu.dev/v1/companies/20123456789 \
  -H "Authorization: Bearer $TOKEN_CUENTA" \
  -H "Accept: application/json"

Copiar

<?php
$token_cuenta = 'pega-aqui-tu-token';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.xmlperu.dev/v1/companies/20123456789');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $token_cuenta,
    'Accept: application/json',
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

Copiar

const TOKEN_CUENTA = 'pega-aqui-tu-token';

const res = await fetch('https://api.xmlperu.dev/v1/companies/20123456789', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${TOKEN_CUENTA}`,
    Accept: 'application/json',
  },
});

const data = await res.json();

Copiar

import requests

TOKEN_CUENTA = "pega-aqui-tu-token"

headers = {
    "Authorization": f"Bearer {TOKEN_CUENTA}",
    "Accept": "application/json",
}

res = requests.delete("https://api.xmlperu.dev/v1/companies/20123456789", headers=headers)
data = res.json()

Respuesta

200 Eliminadaapplication/json

{
  "success": true,
  "message": "Empresa eliminada."
}

422 Tiene movimiento en producciónapplication/json

La empresa ya operó en producción; no puede eliminarse.

{
  "success": false,
  "message": "La empresa tiene movimientos en producción y no puede eliminarse."
}

404 No encontradaapplication/json

{
  "success": false,
  "message": "Empresa no encontrada."
}