Machine translation, not yet reviewed.
RocketPVA
RocketPVA is the SPED bookkeeping validation, editing, and transmission platform from Tax360. It handles the complete lifecycle of SPED files (ECD, ECF) —…
Overview
RocketPVA is the SPED bookkeeping validation, editing, and transmission platform from Tax360. It handles the complete lifecycle of SPED files (ECD, ECF) — from upload and validation through digital signing and government transmission.
The External API (base path: /integration/api/) allows partners and integrators to automate bookkeeping workflows programmatically.
Authentication
All API requests require a valid OAuth2 Bearer Token obtained from the Tax360 IAM service.
Authorization: Bearer <access_token>The token must include the appropriate RPVA roles for each endpoint. See individual endpoint documentation for required roles.
Multi-Tenant Context
Every request is scoped to a customer (tenant). The customer is resolved from the authenticated token — no additional header is needed for external API calls.
Content Types
All endpoints accept and produce the following media types:
| Content Type | Usage |
|---|---|
application/vnd.materimperium.api.v1+json | Primary |
Set the Content-Type and Accept headers accordingly.
Base URL
| Environment | URL |
|---|---|
| Production | https://<API_HOST> |
| Development | https://<API_HOST> |
API Response Envelope
All responses follow the standard Tax360 API envelope:
{
"success": true,
"data": { ... },
"errors": []
}Error responses:
{
"success": false,
"data": null,
"errors": [
{
"code": "BOOKKEEPING_NOT_FOUND",
"message": "Bookkeeping not found for the given filter."
}
]
}Endpoint Index
Uploads
| Method | Path | Description |
|---|---|---|
| POST | /integration/api/uploads/new/{numberParts} | Generate pre-signed URLs for file upload |
| POST | /integration/api/uploads/{objectKey}/{uploadId} | Process uploaded file and create bookkeeping |
Bookkeeping
| Method | Path | Description |
|---|---|---|
| GET | /integration/api/bookkeeping/{bookkeepingId} | Get a single bookkeeping |
| GET | /integration/api/bookkeeping/{spedType}/{year}/{month} | List bookkeepings by SPED type, year, month |
| POST | /integration/api/bookkeeping/{bookkeepingId}/start | Start bookkeeping validation |
| GET | /integration/api/bookkeeping/{bookkeepingId}/download | Download validation results file |
| POST | /integration/api/bookkeeping/{bookkeepingId}/events | Create bookkeeping status event |
| GET | /integration/api/bookkeeping/{bookkeepingId}/results | List validation results (errors/warnings) |
| PATCH | /integration/api/bookkeeping/{bookkeepingId}/transmit | Sign and transmit bookkeeping to government |
Digital Certificates
| Method | Path | Description |
|---|---|---|
| GET | /integration/api/certificate | List digital certificates |
| POST | /integration/api/certificate/upload | Upload a digital certificate |
| POST | /integration/api/certificate/upload/preview | Preview certificate data without uploading |
| DELETE | /integration/api/certificate/{certificateId} | Delete a digital certificate |
Signatories
| Method | Path | Description |
|---|---|---|
| GET | /integration/api/bookkeeping/{bookkeepingId}/signatories | List signatories for a bookkeeping |
| PATCH | /integration/api/bookkeeping/{bookkeepingId}/signatories/{signatoryId}/certificate/{certificateId} | Assign certificate to signatory |
Swagger UI
Interactive API documentation is available at:
| Environment | URL |
|---|---|
| Development | https://<API_HOST>/swagger-ui.html (select "External" group) |