Colombia
DIAN

Connect a DIAN account

DIAN answers only to a signed-in person: their DIAN account's document type, number and password. Signed in on their own behalf (sign_in_as: self, the default) the connection reads the person's own records; signed in on behalf of a third party they represent at DIAN (sign_in_as: third_party, with its NIT in on_behalf_of_nit) it reads that company's or person's records. The person and each third party are separate connections. Each query runs as your organization's own connection, so register one before your first query. Register the account once; Croma keeps the session open and reuses it across queries.

Croma checks the account with the source before saving it.

Credentials are encrypted as soon as they reach Croma, bound to your organization, and can only be opened by the isolated service that signs in to the source on your behalf. They are never returned by the API.

post/co/dian-muisca/connections/v1

Request

  • Base URL: https://api.croma.run
  • URL: https://api.croma.run/co/dian-muisca/connections/v1
  • Auth: HTTP bearer

Request body

sign_in_as'self' | 'third_party'

How the account signs in: self reads the person's own records (a nombre propio); third_party reads the records of the person or company whose NIT goes in on_behalf_of_nit, which the person represents at DIAN (a nombre de un tercero). Defaults to self.

on_behalf_of_nitstring

The NIT of the third party, without the verification digit, dots or dashes. Required when sign_in_as is third_party; leave empty for self.

document_type'CC' | 'CE' | 'TI' | 'RC' | 'PA' | 'PEP' | 'PPT'

Colombian document type. Defaults to CC.

document_numberstring required

The document number of the person whose DIAN account this is (the representative's, when signing in for a third party), without dots or commas.

passwordstring password required

The password of that DIAN account.

authorizedtrue required

Confirms you are the account's owner or have the owner's authorization to use it.

Response

Connected

Changes

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