Generar token de empresa

(Re)genera el token de firma (cpe:sign) de una empresa existente, listo para emitir.

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

Consideraciones

Úsalo si no guardaste el token que devolvió Crear empresa, o para emitir un token adicional.
El valor en claro se muestra una sola vez en esta respuesta.
No revoca los tokens anteriores. Para rotarlos, revoca los viejos desde el panel (empresa → Tokens API).

POSThttps://api.xmlperu.dev/v1/companies/{ruc}/tokenCopiar

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.

Ejemplo de solicitud

Copiar

curl -X POST https://api.xmlperu.dev/v1/companies/20123456789/token \
  -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/token');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
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/token', {
  method: 'POST',
  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.post("https://api.xmlperu.dev/v1/companies/20123456789/token", headers=headers)
data = res.json()

Respuesta

201 Token generadoapplication/json

{
  "success": true,
  "message": "Token de firma generado.",
  "data": {
    "token": {
      "ability": "cpe:sign",
      "plain_text_token": "7|JtYSiBafJnDOdWPUT11SeAtgzr22S1…",
      "note": "Guárdalo ahora: no se vuelve a mostrar. Úsalo como Bearer (token de empresa) para emitir en /v1/cpe."
    }
  }
}

404 No encontradaapplication/json

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