@facturacr/atv-sdk 0.0.25-beta → 1.0.1

package/dist/src/ATV/useCases/createDocument/index.js

@@ -10,14 +10,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateDocumentCommand = void 0;
-const Person_1 = require("../../core/Person");
-const OrderLine_1 = require("../../core/OrderLine");
-const FullConsecutive_1 = require("../../core/FullConsecutive");
-const Document_1 = require("../../core/Document");
-const Clave_1 = require("../../core/Clave");
 const billDocToAtv_1 = require("../../mappers/billDocToAtv");
 const genXML_1 = require("../../../lib/genXML");
-const DocumentType_1 = require("../../core/DocumentType");
+const CreateDocFactory_1 = require("../../core/CreateDocFactory");
 const options = {
     prod: {
         serviceUrl: 'https://api.comprobanteselectronicos.go.cr/v1/recepcion'
@@ -29,11 +24,12 @@ const options = {
 class CreateDocumentCommand {
     constructor(scope) {
         this.serviceUrl = options[scope.mode].serviceUrl;
+        this.createDoc = new CreateDocFactory_1.CreateDocFactory();
     }
     execute(dto) {
         return __awaiter(this, void 0, void 0, function* () {
-            const documentName = dto.document.documentName || 'FacturaElectronica';
-            const document = this.createDocument(dto.document);
+            const documentName = dto.document.documentName || 'FacturaElectronica'; //TODO NotaDebitoElectronica
+            const document = this.createDoc.createDocument(dto.document);
             const atvDocument = (0, billDocToAtv_1.mapDocumentToAtvFormat)(documentName, document);
             const xml = yield (0, genXML_1.genXML)(documentName, atvDocument, dto.signatureOptions);
             const command = yield this.createDocumentCommand(document, xml, dto.token);
@@ -71,66 +67,6 @@ class CreateDocumentCommand {
             };
         });
     }
-    createDocument(document) {
-        const documentType = DocumentType_1.DocumentType.create(document.documentName);
-        const emitter = this.createEmitter(document.emitter);
-        const receiver = this.createReceiver(document.receiver);
-        const clave = this.createClave(document, documentType);
-        const fullConsective = this.createFullConsecutive(document, documentType);
-        const orderLines = this.createOrderLines(document);
-        return Document_1.Document.create({
-            clave,
-            fullConsecutive: fullConsective,
-            orderLines,
-            activityCode: document.activityCode,
-            issueDate: new Date(),
-            emitter,
-            receiver,
-            conditionSale: '01',
-            paymentMethod: '01'
-        });
-    }
-    createEmitter(emitterInput) {
-        return Person_1.Person.create(emitterInput);
-    }
-    createReceiver(receiverInput) {
-        return Person_1.Person.create(receiverInput);
-    }
-    createOrderLines(dto) {
-        return dto.orderLines.map((orderLine, index) => {
-            return OrderLine_1.OrderLine.create({
-                detail: orderLine.detail,
-                unitaryPrice: orderLine.unitaryPrice,
-                lineNumber: orderLine.lineNumber || (index + 1).toString(),
-                code: orderLine.code,
-                quantity: orderLine.quantity,
-                measureUnit: orderLine.measureUnit,
-                totalAmount: orderLine.totalAmount,
-                tax: orderLine.tax
-            });
-        });
-    }
-    createFullConsecutive(dto, docType) {
-        return FullConsecutive_1.FullConsecutive.create({
-            consecutiveIdentifier: dto.consecutiveIdentifier,
-            branch: dto.branch.padStart(3, '0'),
-            terminal: dto.terminal.padStart(5, '0'),
-            documentType: docType.value
-        });
-    }
-    createClave(dto, docType) {
-        return Clave_1.Clave.create({
-            branch: dto.branch,
-            ceSituation: dto.ceSituation,
-            consecutiveIdentifier: dto.consecutiveIdentifier,
-            countryCode: dto.countryCode,
-            docKeyType: docType.value,
-            emitterIdentifier: dto.emitter.identifier.id,
-            identifierType: dto.emitter.identifier.type, // TODO add default
-            securityCode: dto.securityCode,
-            terminal: dto.terminal
-        });
-    }
     encodeXML(xmlStr) {
         const buffer = Buffer.from(xmlStr);
         return buffer.toString('base64');

package/dist/src/ATV/useCases/createDocument/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/ATV/useCases/createDocument/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,8CAA6C;AAC7C,oDAAmD;AACnD,gEAA+D;AAC/D,kDAAiD;AACjD,4CAA2C;AAC3C,6DAA4F;AAC5F,gDAAwC;AAGxC,0DAAyD;AAGzD,MAAM,OAAO,GAA4C;IACvD,IAAI,EAAE;QACJ,UAAU,EAAE,yDAAyD;KACtE;IACD,GAAG,EAAE;QACH,UAAU,EAAE,2EAA2E;KACxF;CACF,CAAA;AAED,MAAa,qBAAqB;IAGhC,YAAY,KAAU;QACpB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,CAAA;IAClD,CAAC;IAEY,OAAO,CAAC,GAAwB;;YAC3C,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,YAAY,IAAI,oBAAoB,CAAA;YACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAClD,MAAM,WAAW,GAAG,IAAA,qCAAkB,EAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;YAC9D,MAAM,GAAG,GAAG,MAAM,IAAA,eAAM,EAAC,YAAY,EAAE,WAAW,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAA;YACzE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAA;YAC1E,OAAO;gBACL,OAAO;gBACP,SAAS,EAAE;oBACT,GAAG;oBACH,QAAQ,EAAE,WAAW;iBACtB;aACF,CAAA;QACH,CAAC;KAAA;IAEa,qBAAqB,CAAC,QAAkB,EAAE,GAAW,EAAE,KAAa;;YAChF,OAAO;gBACL,GAAG,EAAE,IAAI,CAAC,UAAU;gBACpB,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE;oBACJ,KAAK,EAAE,QAAQ,CAAC,KAAK;oBACrB,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE;oBACvC,MAAM,EAAE;wBACN,kBAAkB,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc;wBACnD,oBAAoB,EAAE,QAAQ,CAAC,OAAO,CAAC,YAAY;qBACpD;oBACD,QAAQ,EAAE;wBACR,kBAAkB,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc;wBACpD,oBAAoB,EAAE,QAAQ,CAAC,QAAQ,CAAC,YAAY;qBACrD;oBACD,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;iBACpC;gBACD,OAAO,EAAE;oBACP,aAAa,EAAE,SAAS,GAAG,KAAK;oBAChC,cAAc,EAAE,kBAAkB;iBACnC;aACF,CAAA;QACH,CAAC;KAAA;IAEO,cAAc,CAAC,QAAyC;QAC9D,MAAM,YAAY,GAAG,2BAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;QAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;QACtD,MAAM,cAAc,GAAG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;QACzE,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAClD,OAAO,mBAAQ,CAAC,MAAM,CAAC;YACrB,KAAK;YACL,eAAe,EAAE,cAAc;YAC/B,UAAU;YACV,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,OAAO;YACP,QAAQ;YACR,aAAa,EAAE,IAAI;YACnB,aAAa,EAAE,IAAI;SACpB,CAAC,CAAA;IACJ,CAAC;IAEO,aAAa,CAAC,YAAwD;QAC5E,OAAO,eAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;IACpC,CAAC;IAEO,cAAc,CAAC,aAA0D;QAC/E,OAAO,eAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;IACrC,CAAC;IAEO,gBAAgB,CAAC,GAAoC;QAC3D,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE;YAC7C,OAAO,qBAAS,CAAC,MAAM,CAAC;gBACtB,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,YAAY,EAAE,SAAS,CAAC,YAAY;gBACpC,UAAU,EAAE,SAAS,CAAC,UAAU,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE;gBAC1D,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,WAAW,EAAE,SAAS,CAAC,WAAW;gBAClC,WAAW,EAAE,SAAS,CAAC,WAAW;gBAClC,GAAG,EAAE,SAAS,CAAC,GAAG;aACnB,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,qBAAqB,CAAC,GAAoC,EAAE,OAAqB;QACvF,OAAO,iCAAe,CAAC,MAAM,CAAC;YAC5B,qBAAqB,EAAE,GAAG,CAAC,qBAAqB;YAChD,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;YACnC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;YACvC,YAAY,EAAE,OAAO,CAAC,KAAK;SAC5B,CAAC,CAAA;IACJ,CAAC;IAEO,WAAW,CAAC,GAAoC,EAAE,OAAqB;QAC7E,OAAO,aAAK,CAAC,MAAM,CAAC;YAClB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,qBAAqB,EAAE,GAAG,CAAC,qBAAqB;YAChD,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,UAAU,EAAE,OAAO,CAAC,KAAK;YACzB,iBAAiB,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;YAC5C,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,mBAAmB;YAChE,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB,CAAC,CAAA;IACJ,CAAC;IAEO,SAAS,CAAC,MAAc;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAClC,CAAC;CACF;AApHD,sDAoHC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/ATV/useCases/createDocument/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,6DAA4F;AAC5F,gDAAwC;AAGxC,kEAAsF;AAEtF,MAAM,OAAO,GAA4C;IACvD,IAAI,EAAE;QACJ,UAAU,EAAE,yDAAyD;KACtE;IACD,GAAG,EAAE;QACH,UAAU,EAAE,2EAA2E;KACxF;CACF,CAAA;AAED,MAAa,qBAAqB;IAKhC,YAAY,KAAU;QACpB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,CAAA;QAChD,IAAI,CAAC,SAAS,GAAG,IAAI,mCAAgB,EAAE,CAAA;IACzC,CAAC;IAEY,OAAO,CAAC,GAAwB;;YAC3C,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,YAAY,IAAI,oBAAoB,CAAA,CAAC,4BAA4B;YACnG,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAC5D,MAAM,WAAW,GAAG,IAAA,qCAAkB,EAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;YAC9D,MAAM,GAAG,GAAG,MAAM,IAAA,eAAM,EAAC,YAAY,EAAE,WAAW,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAA;YACzE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAA;YAC1E,OAAO;gBACL,OAAO;gBACP,SAAS,EAAE;oBACT,GAAG;oBACH,QAAQ,EAAE,WAAW;iBACtB;aACF,CAAA;QACH,CAAC;KAAA;IAEa,qBAAqB,CAAC,QAAkB,EAAE,GAAW,EAAE,KAAa;;YAChF,OAAO;gBACL,GAAG,EAAE,IAAI,CAAC,UAAU;gBACpB,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE;oBACJ,KAAK,EAAE,QAAQ,CAAC,KAAK;oBACrB,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE;oBACvC,MAAM,EAAE;wBACN,kBAAkB,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc;wBACnD,oBAAoB,EAAE,QAAQ,CAAC,OAAO,CAAC,YAAY;qBACpD;oBACD,QAAQ,EAAE;wBACR,kBAAkB,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc;wBACpD,oBAAoB,EAAE,QAAQ,CAAC,QAAQ,CAAC,YAAY;qBACrD;oBACD,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;iBACpC;gBACD,OAAO,EAAE;oBACP,aAAa,EAAE,SAAS,GAAG,KAAK;oBAChC,cAAc,EAAE,kBAAkB;iBACnC;aACF,CAAA;QACH,CAAC;KAAA;IAIO,SAAS,CAAC,MAAc;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAClC,CAAC;CACF;AAvDD,sDAuDC"}

package/dist/src/ATV/useCases/createDocument/types.d.ts

@@ -1,48 +1,6 @@
-import { PersonProps } from '@src/ATV/core/Person';
-import { DocumentNames } from '@src/ATV/core/documentNames.types';
 import { InvoiceDocumentContainer } from '@src/types/facturaInterfaces';
 import { Method } from 'axios';
-type PersonInput = PersonProps;
-type TaxInput = {
-    code: string;
-    rateCode: string;
-    rate: number;
-    amount?: number;
-};
-type OrderInput = {
-    detail: string;
-    unitaryPrice: number;
-    lineNumber?: string;
-    code?: string;
-    quantity?: number;
-    measureUnit?: string;
-    totalAmount?: number;
-    subTotal?: number;
-    tax?: TaxInput;
-    totalOrderLineAmount?: number;
-};
 export type DocumentTypes = 'FE';
-type DocumentInput = {
-    emitter: PersonInput;
-    receiver: PersonInput;
-    branch: string;
-    terminal: string;
-    documentName: DocumentNames;
-    countryCode: string;
-    securityCode: string;
-    activityCode: string;
-    consecutiveIdentifier: string;
-    ceSituation: string;
-    orderLines: OrderInput[];
-};
-export type CreateDocumentInput = {
-    document: DocumentInput;
-    token: string;
-    signatureOptions: {
-        buffer: string;
-        password: string;
-    };
-};
 export type Command = {
     url: string;
     method: Method;
@@ -71,4 +29,3 @@ export type CreateAndSendDocumentResponse = {
         document: InvoiceDocumentContainer;
     };
 };
-export {};

package/dist/src/index.d.ts

@@ -1,3 +1,3 @@
 export { Document, InvoiceDocumentContainer, DetalleServicio, Resumen, Persona } from './types/facturaInterfaces';
-export { CreateDocumentInput } from './ATV/useCases/createDocument/types';
+export { CreateDocumentInput } from './ATV/core/CreateDocFactory';
 export { ATV } from './ATV';

package/dist/src/types/facturaInterfaces.d.ts

@@ -66,6 +66,13 @@ export interface Message {
     Mensaje: string;
     DetalleMensaje: string;
 }
+export interface InformacionReferencia {
+    TipoDoc: string;
+    Numero: string;
+    FechaEmision: string;
+    Codigo: string;
+    Razon: string;
+}
 export interface Document {
     Clave: string;
     CodigoActividad: string;
@@ -81,6 +88,7 @@ export interface Document {
     Otros?: {
         OtroTexto: string;
     };
+    InformacionReferencia?: InformacionReferencia;
 }
 export interface InvoiceDocumentContainer {
     [key: string]: Document;

package/examples/createAndSend.ts

@@ -1,6 +1,7 @@
 import fs from 'fs'
-import { createDocumentInputStub } from '@test/stubs/createDocument.stub'
+import { createDocumentInputExample } from '@test/stubs/createDocument.data'
 import { ATV } from '../dist/src'
+import { PersonProps } from 'dist/src/ATV/core/Person'
 
 
 const IS_STG = process.env.IS_STG
@@ -17,10 +18,12 @@ if (!SOURCE_P12_PASSPORT || !SOURCE_P12_URI) {
 
 const pem = fs.readFileSync(SOURCE_P12_URI, 'binary')
 
-console.log('requestStub consecutivo', createDocumentInputStub.consecutiveIdentifier)
-
 // TODO: dynamic param --identifier 1 args[x]
-createDocumentInputStub.consecutiveIdentifier = '4'
+createDocumentInputExample.consecutiveIdentifier = process.env.TEST_CONSECUTIVE
+createDocumentInputExample.emitter.identifier.id = process.env.EMITTER_IDENTIFIER_ID as string;
+createDocumentInputExample.emitter.identifier.type = process.env.EMITTER_IDENTIFIER_TYPE as PersonProps['identifier']['type'];
+
+console.log('requestStub consecutivo', createDocumentInputExample.consecutiveIdentifier)
 
 function getConfimation(atv: ATV, token: string, location: string, ms: number): Promise<any> {
   return new Promise((resolve, reject): any => {
@@ -45,7 +48,7 @@ async function main(): Promise<void> {
     password: PASSWORD_TEST
   })
   const { command, extraData } = await atv.createDocumentCommand({
-    document: createDocumentInputStub,
+    document: createDocumentInputExample,
     token: tokenData.accessToken,
     signatureOptions: {
       buffer: pem,

package/examples/createCreditNote.ts

@@ -1,39 +1,69 @@
-import { ClientPayload } from '@src/types/globalInterfaces'
-import creditNote from '@src/creditNote'
-import getToken from '@src/services/getToken'
-import requestStub from '@test/stubs/frontendRequest.stub'
 import fs from 'fs'
+import { createDocumentInputExample, creditNoteReferenceInfoExample } from '@test/stubs/createDocument.data'
+import { ATV } from '../dist/src'
 
-const frontEndRequest: ClientPayload = requestStub
+
+const IS_STG = process.env.IS_STG
 const USERNAME_TEST = process.env.USERNAME_TEST
 const PASSWORD_TEST = process.env.PASSWORD_TEST
+console.log('process.env.IS_STG', IS_STG)
+
 const SOURCE_P12_URI = process.env.SOURCE_P12_URI
 const SOURCE_P12_PASSPORT = process.env.SOURCE_P12_PASSPORT
+
+if (!SOURCE_P12_PASSPORT || !SOURCE_P12_URI) {
+  throw new Error('No environment. For running examples set .env before.')
+}
+
 const pem = fs.readFileSync(SOURCE_P12_URI, 'binary')
 
+console.log('requestStub consecutivo', createDocumentInputExample.consecutiveIdentifier)
+
+// TODO: dynamic param --identifier 1 args[x]
+createDocumentInputExample.consecutiveIdentifier = '5'
+
+function getConfimation(atv: ATV, token: string, location: string, ms: number): Promise<any> {
+  return new Promise((resolve, reject): any => {
+    setTimeout(() => {
+      console.log('location', location)
+      atv.sendConfirmation({
+        url: location,
+        headers: {
+          'Content-Type': 'application/json',
+          Authorization: 'bearer ' + token
+        }
+      }).then(data => resolve(data))
+        .catch(err => reject(err))
+    }, ms)
+  })
+}
+
 async function main(): Promise<void> {
-  const tokenObj = await getToken({
-    client_id: 'api-stag', // eslint-disable-line
-    client_secret: '', // eslint-disable-line
-    grant_type: 'password', // eslint-disable-line
+  const atv = new ATV({}, 'stg')
+  const tokenData = await atv.getToken({
     username: USERNAME_TEST,
     password: PASSWORD_TEST
   })
-  const token = tokenObj.data.access_token
-  const xmlOpt = {
-    buffer: pem,
-    password: SOURCE_P12_PASSPORT,
-    base64: false
-  }
-  const data = await creditNote({
-    token,
-    frontEndRequest,
-    xmlOpt
+  const { command, extraData } = await atv.createDocumentCommand({
+    document: {
+      ...createDocumentInputExample,
+      documentName: 'NotaCreditoElectronica',
+      referenceInfo: creditNoteReferenceInfoExample
+    },
+    token: tokenData.accessToken,
+    signatureOptions: {
+      buffer: pem,
+      password: SOURCE_P12_PASSPORT
+    }
   })
-  console.log(typeof data)
-  if (data) {
-    console.log(data)
+  console.log('extraData', extraData.xml)
+  const response = await atv.sendDocument(command)
+  if (response.errorCause) {
+    console.log('error response', response)
+    return
   }
+  const confirmationResponse = await getConfimation(atv, tokenData.accessToken, response.location, 2000)
+  console.log({ MensajeHacienda: confirmationResponse.confirmation })
 }
 
 main()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@facturacr/atv-sdk",
-  "version": "0.0.25-beta",
+  "version": "1.0.1",
   "description": "Librería (SDK) de Javascript/NodeJS para acceder al API de Administración Tributaria Virtual (ATV) del Ministerio de Hacienda.",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",

package/src/ATV/core/CreateDocFactory.ts

@@ -0,0 +1,117 @@
+import { PersonProps } from '@src/ATV/core/Person'
+import { DocumentNames } from '@src/ATV/core/documentNames.types'
+import { Person } from '@src/ATV/core/Person'
+import { OrderLine } from '@src/ATV/core/OrderLine'
+import { FullConsecutive } from '@src/ATV/core/FullConsecutive'
+import { Document } from '@src/ATV/core/Document'
+import { Clave } from '@src/ATV/core/Clave'
+import { DocumentType } from '@src/ATV/core/DocumentType'
+import { ReferenceInformation, ReferenceInformationProps } from './ReferenceInformation'
+
+type PersonInput = PersonProps;
+
+type TaxInput = {
+  code: string;
+  rateCode: string;
+  rate: number;
+  amount?: number;
+}
+
+type OrderInput = {
+  detail: string;
+  unitaryPrice: number;
+  lineNumber?: string;
+  code?: string;
+  quantity?: number;
+  measureUnit?: string;
+  totalAmount?: number;
+  subTotal?: number;
+  tax?: TaxInput;
+  totalOrderLineAmount?: number;
+}
+
+type DocumentInput = {
+    emitter: PersonInput;
+    receiver: PersonInput;
+    branch: string; // sucursal
+    terminal: string; // terminal
+    // documentType: DocumentTypes; // @deprecated
+    documentName: DocumentNames;
+    countryCode: string; // codigoPais
+    securityCode: string; // codigoSeguridad
+    activityCode: string;
+    consecutiveIdentifier: string; // consecutivo
+    ceSituation: string; // situacionCE
+    orderLines: OrderInput[];
+    referenceInfo?: ReferenceInfoInput;
+  }
+
+  type ReferenceInfoInput = ReferenceInformationProps;
+  
+  export type CreateDocumentInput = {
+    document: DocumentInput;
+    token: string;
+    signatureOptions: {
+      buffer: string;
+      password: string;
+    };
+  }
+
+export class CreateDocFactory {
+  public createDocument(document: CreateDocumentInput['document']): Document {
+      const documentType = DocumentType.create(document.documentName)
+      const clave = this.createClave(document, documentType)
+      const fullConsective = this.createFullConsecutive(document, documentType)
+      const orderLines = this.createOrderLines(document)
+      return Document.create({
+        clave,
+        fullConsecutive: fullConsective,
+        orderLines,
+        activityCode: document.activityCode,
+        issueDate: new Date(),
+        emitter: Person.create(document.emitter),
+        receiver: Person.create(document.receiver),
+        conditionSale: '01',
+        paymentMethod: '01',
+        referenceInformation: document.referenceInfo ? ReferenceInformation.create(document.referenceInfo) : undefined,
+      })
+    }
+  
+    private createOrderLines(dto: CreateDocumentInput['document']): OrderLine[] {
+      return dto.orderLines.map((orderLine, index) => {
+        return OrderLine.create({
+          detail: orderLine.detail,
+          unitaryPrice: orderLine.unitaryPrice,
+          lineNumber: orderLine.lineNumber || (index + 1).toString(),
+          code: orderLine.code,
+          quantity: orderLine.quantity,
+          measureUnit: orderLine.measureUnit,
+          totalAmount: orderLine.totalAmount,
+          tax: orderLine.tax
+        })
+      })
+    }
+  
+    private createFullConsecutive(dto: CreateDocumentInput['document'], docType: DocumentType): FullConsecutive {
+      return FullConsecutive.create({
+        consecutiveIdentifier: dto.consecutiveIdentifier,
+        branch: dto.branch.padStart(3, '0'),
+        terminal: dto.terminal.padStart(5, '0'),
+        documentType: docType.value
+      })
+    }
+  
+    private createClave(dto: CreateDocumentInput['document'], docType: DocumentType): Clave {
+      return Clave.create({
+        branch: dto.branch,
+        ceSituation: dto.ceSituation,
+        consecutiveIdentifier: dto.consecutiveIdentifier,
+        countryCode: dto.countryCode,
+        docKeyType: docType.value,
+        emitterIdentifier: dto.emitter.identifier.id,
+        identifierType: dto.emitter.identifier.type, // TODO add default
+        securityCode: dto.securityCode,
+        terminal: dto.terminal
+      })
+    }
+}

package/src/ATV/core/Document.ts

@@ -2,6 +2,7 @@ import { Clave } from './Clave'
 import { FullConsecutive } from './FullConsecutive'
 import { OrderLine } from './OrderLine'
 import { Person } from './Person'
+import { ReferenceInformation } from './ReferenceInformation'
 import { SummaryProps } from './Summary.type'
 
 export type InvoiceProps = {
@@ -16,6 +17,7 @@ export type InvoiceProps = {
   deadlineCredit?: string; // PlazoCredito
   paymentMethod?: string; // MedioPago
   summaryInvoice?: SummaryProps; // ResumenFactura
+  referenceInformation?: ReferenceInformation; // InformaciónReferencia
   others?: { // Otros
     OtroTexto: string;
   };
@@ -110,6 +112,10 @@ export class Document {
     }
   }
 
+  get referenceInformation(): ReferenceInformation | undefined {
+    return this.props.referenceInformation
+  }
+
   private isAService(orderLine: OrderLine): boolean {
     const servicesMeasurementUnits = ['Sp', 'St', 'Spe'];
     return servicesMeasurementUnits.includes(orderLine.measureUnit)

package/src/ATV/core/ReferenceInformation.ts

@@ -0,0 +1,41 @@
+export type ReferenceInformationProps = {
+  docType: string;
+  refNumber: string;
+  issueDate: Date;
+  code: string;
+  reason: string;
+}
+
+export class ReferenceInformation {
+  private props: ReferenceInformationProps
+
+  constructor(props: ReferenceInformationProps) {
+    this.props = props
+  }
+
+  get docType(): string {
+    return this.props.docType;
+  }
+
+  get refNumber(): string {
+    return this.props.refNumber;
+  }
+
+  get issueDate(): Date {
+    return this.props.issueDate;
+  }
+
+  get code(): string {
+    return this.props.code;
+  }
+
+  get reason(): string {
+    return this.props.reason;
+  }
+
+  public static create(props: ReferenceInformationProps): ReferenceInformation {
+    return new ReferenceInformation({
+      ...props,
+    })
+  }
+}

package/src/ATV/index.ts

@@ -5,8 +5,9 @@ import * as parser from 'fast-xml-parser'
 import qs from 'querystring'
 import { ConfirmationMessageRaw } from '@src/types/facturaInterfaces'
 import { ATVOptions, ConfirmationMessage, Mode, SendConfirmationInput, SendResponse } from './types'
-import { Command, CreateAndSendDocumentResponse, CreateDocumentInput } from './useCases/createDocument/types'
+import { Command, CreateAndSendDocumentResponse } from './useCases/createDocument/types'
 import { CreateDocumentCommand } from './useCases/createDocument'
+import { CreateDocumentInput } from './core/CreateDocFactory'
 
 export class ATV {
   public readonly options: ATVOptions

package/src/ATV/mappers/billDocToAtv.ts

@@ -1,7 +1,8 @@
-import { Document, InvoiceDocumentContainer, DetalleServicio, Resumen, Persona } from '@src/types/facturaInterfaces'
+import { Document, InvoiceDocumentContainer, DetalleServicio, Resumen, Persona, InformacionReferencia } from '@src/types/facturaInterfaces'
 import { Document as DomainDocument } from '../core/Document'
 import { OrderLine } from '../core/OrderLine'
 import { Person } from '../core/Person'
+import { ReferenceInformation } from '../core/ReferenceInformation'
 
 type AtvFormat = InvoiceDocumentContainer
 
@@ -86,6 +87,16 @@ const mapPerson = (person: Person): Persona => {
   return atvPerson;
 }
 
+const mapReferenceInformation = (referenceInfo: ReferenceInformation): InformacionReferencia => {
+  return {
+    TipoDoc: referenceInfo.docType,
+    Numero: referenceInfo.refNumber,
+    FechaEmision: referenceInfo.issueDate.toISOString(),
+    Codigo: referenceInfo.code,
+    Razon: referenceInfo.reason
+  }
+}
+
 export const mapDocumentToAtvFormat = (docName: string, document: DomainDocument): AtvFormat => {
   const key = docName
   const doc: Document = {
@@ -102,6 +113,9 @@ export const mapDocumentToAtvFormat = (docName: string, document: DomainDocument
     ResumenFactura: mapSummaryInvoice(document.summaryInvoice),
     Otros: document.others
   }
+  if (document.referenceInformation) {
+    doc.InformacionReferencia = mapReferenceInformation(document.referenceInformation);
+  }
   return {
     [key]: doc
   }

package/src/ATV/useCases/createDocument/index.ts

@@ -1,14 +1,10 @@
-import { Person } from '@src/ATV/core/Person'
-import { OrderLine } from '@src/ATV/core/OrderLine'
-import { FullConsecutive } from '@src/ATV/core/FullConsecutive'
 import { Document } from '@src/ATV/core/Document'
-import { Clave } from '@src/ATV/core/Clave'
+
 import { mapDocumentToAtvFormat as mapBillToAtvFormat } from '@src/ATV/mappers/billDocToAtv'
 import { genXML } from '@src/lib/genXML'
-import { CreateAndSendDocumentResponse, CreateDocumentInput, Command } from './types'
+import { CreateAndSendDocumentResponse, Command } from './types'
 import { ATV } from '@src/ATV'
-import { DocumentType } from '@src/ATV/core/DocumentType'
-export type { CreateDocumentInput as CreateBillInput } from './types'
+import { CreateDocFactory, CreateDocumentInput } from '@src/ATV/core/CreateDocFactory'
 
 const options: { [key: string]: { serviceUrl: string}} = {
   prod: {
@@ -22,13 +18,16 @@ const options: { [key: string]: { serviceUrl: string}} = {
 export class CreateDocumentCommand {
   private readonly serviceUrl: string
 
+  private readonly createDoc: CreateDocFactory;
+
   constructor(scope: ATV) {
     this.serviceUrl = options[scope.mode].serviceUrl
+    this.createDoc = new CreateDocFactory()
   }
 
   public async execute(dto: CreateDocumentInput): Promise<CreateAndSendDocumentResponse> {
-    const documentName = dto.document.documentName || 'FacturaElectronica'
-    const document = this.createDocument(dto.document)
+    const documentName = dto.document.documentName || 'FacturaElectronica' //TODO NotaDebitoElectronica
+    const document = this.createDoc.createDocument(dto.document)
     const atvDocument = mapBillToAtvFormat(documentName, document)
     const xml = await genXML(documentName, atvDocument, dto.signatureOptions)
     const command = await this.createDocumentCommand(document, xml, dto.token)
@@ -65,71 +64,7 @@ export class CreateDocumentCommand {
     }
   }
 
-  private createDocument(document: CreateDocumentInput['document']): Document {
-    const documentType = DocumentType.create(document.documentName)
-    const emitter = this.createEmitter(document.emitter)
-    const receiver = this.createReceiver(document.receiver)
-    const clave = this.createClave(document, documentType)
-    const fullConsective = this.createFullConsecutive(document, documentType)
-    const orderLines = this.createOrderLines(document)
-    return Document.create({
-      clave,
-      fullConsecutive: fullConsective,
-      orderLines,
-      activityCode: document.activityCode,
-      issueDate: new Date(),
-      emitter,
-      receiver,
-      conditionSale: '01',
-      paymentMethod: '01'
-    })
-  }
-
-  private createEmitter(emitterInput: CreateDocumentInput['document']['emitter']): Person {
-    return Person.create(emitterInput)
-  }
-
-  private createReceiver(receiverInput: CreateDocumentInput['document']['receiver']): Person {
-    return Person.create(receiverInput)
-  }
-
-  private createOrderLines(dto: CreateDocumentInput['document']): OrderLine[] {
-    return dto.orderLines.map((orderLine, index) => {
-      return OrderLine.create({
-        detail: orderLine.detail,
-        unitaryPrice: orderLine.unitaryPrice,
-        lineNumber: orderLine.lineNumber || (index + 1).toString(),
-        code: orderLine.code,
-        quantity: orderLine.quantity,
-        measureUnit: orderLine.measureUnit,
-        totalAmount: orderLine.totalAmount,
-        tax: orderLine.tax
-      })
-    })
-  }
-
-  private createFullConsecutive(dto: CreateDocumentInput['document'], docType: DocumentType): FullConsecutive {
-    return FullConsecutive.create({
-      consecutiveIdentifier: dto.consecutiveIdentifier,
-      branch: dto.branch.padStart(3, '0'),
-      terminal: dto.terminal.padStart(5, '0'),
-      documentType: docType.value
-    })
-  }
-
-  private createClave(dto: CreateDocumentInput['document'], docType: DocumentType): Clave {
-    return Clave.create({
-      branch: dto.branch,
-      ceSituation: dto.ceSituation,
-      consecutiveIdentifier: dto.consecutiveIdentifier,
-      countryCode: dto.countryCode,
-      docKeyType: docType.value,
-      emitterIdentifier: dto.emitter.identifier.id,
-      identifierType: dto.emitter.identifier.type, // TODO add default
-      securityCode: dto.securityCode,
-      terminal: dto.terminal
-    })
-  }
+  
 
   private encodeXML(xmlStr: string): string {
     const buffer = Buffer.from(xmlStr)