Sandbox

Operaciones que solo existen en cuentas demo (/sandbox).

En una cuenta demo los documentos se generan de forma válida pero no se envían a la DNIT: la respuesta se simula. Eso permite integrar y probar todo el circuito, webhooks incluidos.

Por defecto todo se aprueba. Para probar el camino de error hay dos formas:

• RUC de receptor reservado. 99999901 fuerza un rechazo de la DNIT con código 0160; 99999902 fuerza un error de procesamiento de lote con código 0301. Son la parte numérica del RUC: hay que mandarlos con dígito verificador, '99999901-7', porque la API lo exige.
• Este recurso, que cambia el estado de un documento ya emitido.

En ambos casos se disparan los mismos eventos y webhooks que en el flujo real.

Constructors

Constructor

new Sandbox(transport): Sandbox;

Parameters

Parameter	Type
transport	Transport

Returns

Sandbox

Properties

RUC_RECHAZO

readonly static RUC_RECHAZO: "99999901" = '99999901';

Parte numérica del RUC que fuerza un rechazo de la DNIT (código 0160). Hay que mandarlo con dígito verificador: `${Sandbox.RUC_RECHAZO}-7`.

---

RUC_ERROR_LOTE

readonly static RUC_ERROR_LOTE: "99999902" = '99999902';

Ídem, para un error de procesamiento de lote (código 0301).

Methods

forceStatus()

forceStatus(cdc, status): Promise<Document>;

Fuerza el estado de un documento ya emitido.

Parameters

Parameter	Type	Description
cdc	string	-
status	"error" | "approved"	'approved' o 'error'.

Returns

Promise<Document>

Throws

si la cuenta no es demo, la API responde SANDBOX_ONLY.