Empresas

Dar de alta a una empresa

Este endpoint permite dar de alta empresas en la API con las configuraciones necesarias para enviar documentos a la DGII

post/company

Request body

namestring required

Nombre/Razón social de la empresa

tradeNamestring

Nombre comercial (opcional)

identificationstring required

Identificación de la empresa

type'main' | 'associated'

Tipo de empresa

addressstring required

Dirección de la compañía

provincestring

Provincia donde está situada la compañía

municipalitystring

Municipio donde está situada la compañía

emailstring email

Correo electrónico de la compañía

logostring

Imagen del logo en base64 a incluir en todos los documentos PDF. Consideraciones:

  • El tamaño máximo de la imagen es de 150 KB.
  • Si un documento es creado con un logo, este siempre mostrará ese logo. Si el logo es actualizado posteriormente, los documentos creados anteriormente no serán actualizados para mostrar el nuevo logo. Por lo tanto, se recomienda crear documentos con un logo solo después de haber cargado y establecido el logo final.

Example request

{
  "name": "Mi compañía",
  "tradeName": "Mi compañía S.A",
  "identification": "12345678",
  "address": "30 De Marzo 9 Sd",
  "province": "Santo domingo",
  "municipality": "30 De Marzo 9 Sd",
  "email": "alanube@example.com",
  "certificate": {
    "name": "certificado digital",
    "extension": "pfx",
    "content": "MIIdAgIBAzCCHMgGCSqGSIb3DQEHAaCCHLkEghy1.....A=",
    "password": "sEcR3T"
  },
  "webhooks": {
    "general": {
      "governmentStatusChanged": {
        "url": "https://mi-compania.com/api/v1/update-company",
        "headers": {
          "Authorization": "Bearer tokendeautenticacion"
        },
        "status": "active"
      }
    },
    "documents": {
      "emissionFinished": {
        "url": "https://mi-compania.com/api/v1/update-document",
        "headers": {
          "Authorization": "Bearer tokendeautenticacion"
        },
        "status": "active",
        "auth": {
          "status": "active",
          "url": "https://mi-compania.com/api/v1/auth-webhook",
          "headersRequest": {
            "Authorization": "Bearer tokendeautenticacion"
          },
          "body": {
            "status": "active"
          },
          "headersResponse": {
            "fields": [
              "jwt"
            ],
            "cache": {
              "ttl": 3600
            }
          }
        }
      },
      "cancellations": {
        "url": "https://mi-compania.com/api/v1/save-cancellation-info",
        "headers": {
          "Authorization": "Bearer tokendeautenticacion"
        },
        "status": "active"
      },
      "reception": {
        "url": "https://mi-compania.com/api/v1/reception-event",
        "headers": {
          "Authorization": "Bearer tokendeautenticacion"
        },
        "status": "active"
      }
    }
  }
}

Response

— unresolved $ref