POST/issuer/establishments

Crear o actualizar un establecimiento

Send request

Use the documented inputs to call this endpoint directly.

API serverbase URL

Bearer tokenBearerAuthoptional

Stored only in this browser for the BearerAuth security scheme and reused on every API page in this group.

Request body

application/jsonrequired

addressstringrequired

codestringrequired

Código de 4 dígitos del local anexo (no puede ser 0000).

emailstringoptional

isDefaultbooleanoptional

namestringrequired

phonestringoptional

rucstringoptional

seriesarray<>optional

ubigeostringrequired

Ubigeo INEI de 6 dígitos.

Responses

201application/json

Correcto.

{
  "active": true,
  "address": "string",
  "code": "string",
  "email": "string",
  "isDefault": true,
  "name": "string",
  "phone": "string",
  "series": [
    {
      "active": true,
      "documentType": "string",
      "establishmentCode": "string",
      "mode": "string",
      "nextNumber": 1.5,
      "series": "string"
    }
  ],
  "ubigeo": "string"
}

activebooleanrequired

addressstringrequired

codestringrequired

emailstringrequired

isDefaultbooleanrequired

namestringrequired

phonestringrequired

seriesarray<>optional

ubigeostringrequired

400application/json

VALIDATION_ERROR: El cuerpo, los parámetros o una regla del comprobante no son válidos. fields indica el campo.

{
  "error": {
    "code": "string",
    "fields": {},
    "message": "string",
    "requestId": "",
    "retryable": true
  }
}

errorrequired

401application/json

UNAUTHENTICATED: Falta la clave API o no es válida.

{
  "error": {
    "code": "string",
    "fields": {},
    "message": "string",
    "requestId": "",
    "retryable": true
  }
}

errorrequired

402application/json

TRIAL_EXPIRED: La prueba gratuita venció.

TRIAL_EXHAUSTED: La prueba gratuita consumió sus operaciones.

{
  "error": {
    "code": "string",
    "fields": {},
    "message": "string",
    "requestId": "",
    "retryable": true
  }
}

errorrequired

403application/json

WORKSPACE_SUSPENDED: El workspace está suspendido.

ISSUER_FORBIDDEN: El RUC no pertenece al workspace de la clave.

{
  "error": {
    "code": "string",
    "fields": {},
    "message": "string",
    "requestId": "",
    "retryable": true
  }
}

errorrequired

409application/json

SERIES_DUPLICATED: La serie ya existe en el RUC.

{
  "error": {
    "code": "string",
    "fields": {},
    "message": "string",
    "requestId": "",
    "retryable": true
  }
}

errorrequired

422application/json

SERIES_ESTABLISHMENT_MISMATCH: La serie pertenece a otro establecimiento.

{
  "error": {
    "code": "string",
    "fields": {},
    "message": "string",
    "requestId": "",
    "retryable": true
  }
}

errorrequired

429application/json

RATE_LIMITED: Se superó el límite de peticiones. Respeta el header Retry-After.

{
  "error": {
    "code": "string",
    "fields": {},
    "message": "string",
    "requestId": "",
    "retryable": true
  }
}

errorrequired

500application/json

INTERNAL_ERROR: Error interno. Reintenta y comparte el requestId con soporte.

{
  "error": {
    "code": "string",
    "fields": {},
    "message": "string",
    "requestId": "",
    "retryable": true
  }
}

errorrequired