Generalities - HKA Reception Direct Integration Manual Index

Version history

Version	release date	Description
0	12/01/22	initial version

How to get support

• First level support:

Telephone / email / chat or teleconference support during 5x8 hours to attend to queries and user failures.

• Second level support:

Support remote resolution of incidents in the system in 5x8 hours

Write to: soporte@thefactoryhka.com.co

For inquiries regarding configurations and errors in the Portal:

• soporte_fel_co@thefactoryhka.com

For questions regarding ERP configurations, software house and integration:

• integracion_fel_co@thefactoryhka.com

Telephone service lines:

• MASTER +57 (1) 746.08.12
• +57 (1) 508.8990
• +57 (1) 517.6795
• +57 (1) 517.6796
• +57 (1) 311.3063
  • Technical Support → Option 2
  • Integration → Option 5 Then Option 1

For Sessions:

Sessions Support

Handling methods in soap. Aimed at: Commercial Agencies - Allied Software Houses - End Clients

Schedule: Tuesday and Thursday from 8:30 AM

Link Support Sessions

Sessions Integration Area

Solution Integration Cases

Aimed at: Clients who carry out Software developments to integrate with TFHKA, Allied Software Houses

Schedule: Tuesday and Thursday from 8:30 AM

Link Sessions Integration

General description

This document describes the integration process between the electronic receipt model according to the regulatory and technical updates from the DIAN and/or own controls in our integration model.

For the development of this document, the Technical Annexes V1.8 (current) (released on February 9, 2021 by the DIAN) were taken as a reference.

Note: Not all the functionalities, catalogs and reception scenarios referring to the Technical Annex V1.8 are enabled by the DIAN.

What is The Factory HKA-RECEIPT?

It is an electronic receipt platform, designed to comply with current legislation in Colombia and offer added values through complementary services.

What is Dintegration?

It is a product aimed at the integrator and is made up of the following components:

• Integration manuals.
• Bag of support hours via email and/or teleconferences.
• Credentials for test environment (DEMO) and production.

direct integration

The integration is an essential activity for the implementation of the electronic receipt in a Billing System or Administrative Software (ERP) and it will be done only once. This activity consists of linking two platforms with different technologies with the aim of transmitting the necessary data for the construction of documents and the successful monitoring of the life cycle.

In the case of direct integration, the communication is directly connected to the Web Service, which has the advantage of total control of the life cycle of the electronic document, from the origin of the data, through the transmission process to its delivery, acknowledgment and validation. This form of integration allows you to react faster and more efficiently to errors or inconsistencies that arise in the process.

Direct integration is a unique process between the embedded software and The Factory HKA-RECEIPT platform.

@Important: It is not necessary to implement additional integration with the DIAN, since there is full functionality for monitoring the status of the document.

Requirements for receiving documents

Email structure:

According to the official statement of the Colombian Chamber of Electronic Commerce of August 28, 2020, the provision of attachments indicates that for each electronic document an email must be sent with a single .zip attachment, which must contain a mandatory the corresponding AttachedDocument xml file and optionally the .pdf file.

Official statement of the Colombian Chamber of Electronic Commerce

Alternative for uploading urgent documents:

The provider can access your usuario Proveedor and perform the manual upload of your document in the Option documents -> Subir documentos.

Acquirer document type:

For the reception of documents it is required to validate that the type of document of the acquirer or receiver corresponds to NIT, the above based on technical annex 1.8, otherwise the electronic document may be rejected by the FAJ48 rule.

Technical annex 1.8

Nit of the receiver must not contain the DV:

According to technical annex 1.8, the NIT of the acquirer or recipient of the electronic documents must be reported in a field other than the DV. Failure to comply with this rule may result in the document being rejected by the FAK63 and FAK64 rules.

Technical annex 1.8

Digital signature validity:

In Resolution 000012 point 8. Supplement A: Signature policy, the details regarding the validity of the electronic document signature are specified, for the reception of electronic documents it is required that they have a valid signature as indicated in the resolution 000012.

Resolution 000012

Direct integration scheme for SOAP URL Electronic Invoice

We have a SOAP web service for testing in which initial validations are made against the DIAN, this allows them to validate the structure of the Invoice object and data origin proposed by TFHKA.

URL DEMO environment (test environment in which broadcasts are not transmitted to the DIAN):

[http://demorecepcion21.thefactoryhka.com.co/ReceptorWS.svc?wsdl ] --> DEMO (HTTP)

URL Productive Environment (environment in which the issuances corresponding to the qualification set are made and later the issuance of documents in operation):

[https://recepcion21.thefactoryhka.com.co/ReceptorWS.svc?wsdl ] --> PRODUCTION (HTTPS)

@IMPORTANT: The url of the SOAP service in production is only functional under the https protocol.

Note: If you cannot access said configuration in the system interface, please contact your software house or ERP developer so that they can validate what has been previously described. If the problem is not solved with the aforementioned, please send an email to the integration area integracion_fel_co@thefactoryhka.com with the following information:

• Request sent to the Web Service.
• Capture of the configuration made in the system where the information of the indicated URLs and tokens is displayed..

What is Electronic Receipt?

Those who purchase goods and/or services and are electronic billers are obliged to receive electronic invoices via email. The receipt of electronic invoices receives the document through which a supplier certifies that he has provided us with a product or service with a certain price, in digital form.

Who is required to implement Electronic Receipt?

Taxpayers who want the Drecepcion product, a means to receive and control their electronic documents. The direct reception from the portal is designed for people with a low and high volume of operations, such as small, medium and large companies or independent professionals. The portal is the configuration tool for all media that interact with the Drecepcion platform (Mobile Application or ERP).

Advantages of Electronic Reception

• HKARecepcion allows to optimize the management of electronic documents with the automatic identification of suppliers.
• Allows you to establish business rules that facilitate document management
• The system also allows the type of supplier to be categorized manually, to group suppliers and improve search filters in document management.
• Allows document management by grouping the documents and giving the user the possibility to visualize the graphic representation, download the XML, manage custom statuses and DIAN status.
• It also allows incorporating the company's workflow into the system to manage documents.
• Guarantees the sending of DIAN events and obtaining a response from them.
• Facilitates the search for a document or several of them in the system because it has the following search filters: by status, by provider, by type of provider, by infodata and by dates.