Certificados

Crea un nuevo certificado

post/certificates

Request

  • Base URL: https://api.datil.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.datil.com/certificates
  • Auth: none declared

Request body

type'ec/instant' | 'ec/individual' | 'ec/sole-proprietorship' | 'ec/business-director' | 'ec/business-employee' | 'ec/organization' | 'jm/instant' | 'pa/instant' | 'pe/instant' | 'br/instant' | 'bo/instant' | 'sv/instant' | 'gt/instant' | 'hn/instant' | 'ni/instant' required

Tipo de certificado: ec/instant: Certificado instantáneo con validez de 1 día, solo para personas naturales. ec/individual: Certificado para persona natural, solo con número de cédula. No incluye el RUC del titular.

ec/sole-proprietorship: Certificado para persona natural con RUC.

ec/business-director: Certificado para representante legal de una empresa.

ec/business-employee: Certificado para miembro de una empresa (ej. contador).

ec/organization: Certificado para representante legal de organizaciones públicas o privadas.

jm/instant: Certificado virtual para firma simple en Jamaica.

pe/instant: Certificado virtual para firma simple en Perú.

pa/instant: Certificado virtual para firma simple en Panamá. br/instant: Certificado virtual para firma simple en Brasil.

bo/instant: Certificado virtual para firma simple en Bolivia.

sv/instant: Certificado virtual para firma simple en El Salvador.

gt/instant: Certificado virtual para firma simple en Guatemala.

hn/instant: Certificado virtual para firma simple en Honduras.

ni/instant: Certificado virtual para firma simple en Nicaragua.

validitystring required

Validez del certificado en días. Valores aceptados: 1, 365, 732, 1095, 1825

passwordstring

Contraseña del certificado.

Example request

{
  "type": "ec/individual",
  "validity": "365",
  "password": "clave-de-pruebas",
  "principal": {
    "first_name": "Juan",
    "middle_name": "Andres",
    "last_name": "Martinez",
    "second_last_name": "Lopez",
    "email": "prueba@prueba.com",
    "mobile_phone": "0999999999",
    "legal_id_type": "ec-cedula",
    "legal_id": "0922288828",
    "position": "Gerente General",
    "tax_id_type": "ec-ruc",
    "tax_id": "0922288828",
    "address": {
      "line_1": "Calle A",
      "locality": "Lima",
      "administrative_district_level_1": "Miraflores",
      "administrative_district_level_2": "Lima",
      "city": "Lima",
      "province": "Lima",
      "tax_code": "0000",
      "country": "PE"
    },
    "selfie_photo": "abcd",
    "id_service_photo": "abcd",
    "ip_address": "10.0.0.1",
    "user_agent": "WhatsApp",
    "proof_of_id": "https://portal.com/id/12345"
  },
  "organization": {
    "legal_name": "Empresa S.A.",
    "tax_id_type": "ec-ruc",
    "tax_id": "0922288828",
    "address": {
      "line_1": "Calle A",
      "locality": "Lima",
      "administrative_district_level_1": "Miraflores",
      "administrative_district_level_2": "Lima",
      "city": "Lima",
      "province": "Lima",
      "tax_code": "0000",
      "country": "PE"
    },
    "position": "Gerente General"
  }
}

Response

OK

idstring uuid required

Identificador único del certificado, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.

type'ec/instant' | 'ec/individual' | 'ec/sole-proprietorship' | 'ec/business-director' | 'ec/business-employee' | 'ec/organization' | 'jm/instant' | 'pa/instant' | 'pe/instant' | 'br/instant' | 'bo/instant' | 'sv/instant' | 'gt/instant' | 'hn/instant' | 'ni/instant' required

Tipo de certificado: ec/instant: Certificado instantáneo con validez de 1 día, solo para personas naturales. ec/individual: Certificado para persona natural, solo con número de cédula. No incluye el RUC del titular.

ec/sole-proprietorship: Certificado para persona natural con RUC.

ec/business-director: Certificado para representante legal de una empresa.

ec/business-employee: Certificado para miembro de una empresa (ej. contador).

ec/organization: Certificado para representante legal de organizaciones públicas o privadas.

jm/instant: Certificado virtual para firma simple en Jamaica.

pe/instant: Certificado virtual para firma simple en Perú.

pa/instant: Certificado virtual para firma simple en Panamá.

br/instant: Certificado virtual para firma simple en Brasil.

bo/instant: Certificado virtual para firma simple en Bolivia.

sv/instant: Certificado virtual para firma simple en El Salvador.

gt/instant: Certificado virtual para firma simple en Guatemala.

hn/instant: Certificado virtual para firma simple en Honduras.

ni/instant: Certificado virtual para firma simple en Nicaragua.

environment'live' | 'test' required

Tipo de ambiente del certificado.

live: Ambiente de producción. test: Ambiente de pruebas.

Los certificados en ambiente de pruebas simulan su emisión y las acciones que realices con ellos (ej. firmas electrónicas), por lo que no tienen costo.

Los certificados en ambiente de producción si se emiten y tienen costo.

validitynumber double required

Validez del certificado en días. Valores aceptados: 1, 365, 732, 1095, 1825

createdstring date-time required

Fecha de creación de la solicitud de emisión del certificado, en formato RFC3339.

issuedstring date-time required

Fecha de emisión del certificado, en formato RFC3339.

expirystring date-time required

Fecha de expiración del certificado, en formato RFC3339.

serial_numberstring

Serie del certificado.

statusstring required

Estado del certificado: issued, draft o processing.

Example response

{
  "id": "0ca049e5-8d05-4d65-871a-82b6bdf508f7",
  "validity": 365,
  "created": "2022-01-01T00:00:00Z",
  "issued": "2022-01-01T00:00:00Z",
  "expiry": "2025-01-01T00:00:00Z",
  "serial_number": "11:22:22:22:00:22",
  "principal": {
    "first_name": "Juan",
    "middle_name": "Andres",
    "last_name": "Martinez",
    "second_last_name": "Lopez",
    "email": "prueba@prueba.com",
    "mobile_phone": "0999999999",
    "legal_id": "0922288828",
    "legal_id_type": {
      "type": "pe-ruc",
      "code": "6",
      "name": "RUC"
    },
    "position": "Gerente General",
    "tax_id": "0922288828001",
    "tax_id_type": {
      "type": "pe-ruc",
      "code": "6",
      "name": "RUC"
    },
    "address": {
      "line_1": "Calle A",
      "locality": "Lima",
      "administrative_district_level_1": "Miraflores",
      "administrative_district_level_2": "Lima",
      "city": "Lima",
      "province": "Lima",
      "tax_code": "0000",
      "country": {
        "code": "PE",
        "name": "Perú"
      }
    },
    "ip_address": "10.0.0.1",
    "user_agent": "WhatsApp",
    "proof_of_id": "https://portal.com/id/12345"
  },
  "status": "issued",
  "organization": {
    "legal_name": "Empresa S.A.",
    "tax_id_type": {
      "type": "pe-ruc",
      "code": "6",
      "name": "RUC"
    },
    "tax_id": "0922288828",
    "address": {
      "line_1": "Calle A",
      "locality": "Lima",
      "administrative_district_level_1": "Miraflores",
      "administrative_district_level_2": "Lima",
      "city": "Lima",
      "province": "Lima",
      "tax_code": "0000",
      "country": {
        "code": "PE",
        "name": "Perú"
      }
    },
    "position": "Gerente General"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.