Entities

Upload the signing certificate

POST
/v1/ec/entities/{id}/certificates

The .p12 and its password are verified (the certificate must belong to the entity and be valid) and sealed: the API can no longer open them; only the signing process can. The last certificate you upload signs test and live documents while it is valid; when it expires no earlier one signs, even if still valid: upload a new one.

Authorization

AuthorizationBearer <token>

Your API key, which acts for the one business it was created for: fb_sandbox_… issues in sandbox, fb_test_… in test, the tax authority's testing service, and fb_live_… in live.

In: header

Path Parameters

id*string
Formatuuid

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

file*file

The .p12 (or .pfx) file.

Formatbinary
password*string
Length1 <= length <= 200

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/ec/entities/497f6eca-6276-4993-bfeb-53cbbbba6f08/certificates" \  -F file="string" \  -F password="string"
{  "holder": "string",  "holder_identification": "string",  "holder_identification_type": "cedula",  "kind": "natural_person",  "issuer_name": "string",  "subject": "string",  "issuer": "string",  "serial_number": "string",  "valid_from": "2019-08-24T14:15:22Z",  "valid_until": "2019-08-24T14:15:22Z"}