Negocios | API de facturación electrónica

Un negocio representa al emisor de comprobantes electrónicos: su RUC, razón social, ambiente SRI, firma electrónica y logotipo. Antes de emitir cualquier documento, debes tener al menos un negocio creado y con firma cargada.

GET/businesses API Key

Lista los negocios pertenecientes a un usuario.

Query string

Campo	Tipo	Requerido	Descripción
userId	int	Sí	ID del usuario propietario.

Respuesta 200

json

{
  "data": [
    {
      "id": 1,
      "ruc": "0105678901001",
      "businessName": "Mi Empresa S.A.",
      "environmentId": 1,
      "hasSignature": true
    }
  ]
}

GET/businesses/{id} API Key

Obtiene un negocio por su ID.

Query string

Campo	Tipo	Requerido	Descripción
userId	int	Sí	ID del usuario propietario.

POST/businesses API Key

Crea un nuevo negocio.

Body (application/json)

Campo	Tipo	Requerido	Descripción
userId	int	Sí	ID del usuario propietario.
environmentId	int	No	Ambiente SRI: 1 = Pruebas, 2 = Producción.
ruc	string(13)	Sí	RUC del negocio.
businessName	string	Sí	Razón social.
tradename	string	No	Nombre comercial.
email	string	No	Correo de contacto.
phone	string(20)	No	Teléfono.
issuancePointCode	string(3)	No	Código del punto de emisión por defecto.
specialTaxpayer	string(20)	No	Número de contribuyente especial, si aplica.
retentionAgent	string(20)	No	Número de agente de retención, si aplica.
accounting	bool	No	Indica si el negocio lleva contabilidad.
rimpe	bool	No	Indica si pertenece al régimen RIMPE.
types	array	No	Códigos de tipo de comercio (ver /catalogs/business-types). Un comercio puede tener más de uno; determina qué campos y qué impuestos aplican.
minturRegistryNumber	string(50)	No	Registro / catastro MINTUR. Solo para comercios de tipo TURISMO; junto con un LUAF vigente habilita el IVA 8% en feriados decretados.
luafExpiresAt	string	No	Vencimiento del LUAF (YYYY-MM-DD). Solo para comercios de tipo TURISMO.

Ejemplo de request

json

{
  "userId": 1,
  "environmentId": 1,
  "ruc": "0105678901001",
  "businessName": "Mi Empresa S.A.",
  "tradename": "Mi Empresa",
  "email": "contacto@miempresa.com",
  "phone": "0991234567",
  "issuancePointCode": "001",
  "accounting": true,
  "rimpe": false
}

PUT/businesses/{id} API Key

Actualiza un negocio existente. Envía solo los campos a modificar.

json

{
  "userId": 1,
  "tradename": "Mi Empresa Actualizada",
  "email": "nuevo@miempresa.com"
}

POST/businesses/{id}/files API Key

Sube o reemplaza la firma electrónica (.p12) y/o el logotipo del negocio.

Body (multipart/form-data)

Campo	Tipo	Requerido	Descripción
sign	file	No	Archivo .p12 con la firma electrónica vigente.
logo	file	No	Imagen PNG o JPG del logotipo del negocio.

POST/businesses/{id}/signature:verify API Key

Verifica que la firma electrónica del negocio sea válida y esté vigente.

Útil para mostrar al usuario el estado de su firma antes de la emisión y avisarle si está próxima a vencer.

DELETE/businesses/{id} API Key

Elimina (soft-delete) un negocio.

json

{ "userId": 1 }