Create an organization and its test twin, with the RUC of the company
Creates the pair. tax_id is required: the RUC is checked by its check digit and looked up in SUNAT data before anything is created. The live organization is born with its issuer: the RUC, fixed from now on, and the legal name, fiscal address and UBIGEO that SUNAT data shows (ruc.verification: verified). If the lookup does not answer, the pair is created all the same with the RUC unverified and the service verifies it by itself later; GET /v1/readiness says when. The test organization is born ready to issue against the simulated provider: a test issuer with the same RUC (editable there) and the series F001 and B001. The caller becomes its owner.
POST
https://api.invox.page/v1/organizationsAuthorization
Header parameters
Request body JSON required
Returns
200
A retry: the pair created by the first request.
201
The pair that was created.
400
validation_failed: The request is not valid · malformed_request: The request body is not valid JSON · idempotency_key_required: This write needs an Idempotency-Key header
JSON
401
unauthenticated: No credential was sent · invalid_credential: The credential is not valid
JSON
403
person_credential_required: This route is for a person, not for a service account
JSON
409
organization_limit_reached: This person already owns the maximum number of organizations
JSON
422
idempotency_key_reused: This Idempotency-Key was already used with a different request · tax_id_required: The RUC of the organization is required · tax_id_invalid: The RUC is not valid: its check digit does not match · ruc_not_found: SUNAT does not know this RUC
JSON
429
rate_limited: Too many requests
JSON
500
internal_error: The service failed
JSON
503
service_unavailable: The service cannot answer right now
JSON