@facturacr/atv-sdk 0.0.26-beta → 1.1.0

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

@@ -5,22 +5,25 @@ import { Method } from 'axios'
 
 export type DocumentTypes = 'FE'
 
+type CommandData = {
+  clave: string;
+  fecha: string;
+  emisor: {
+    tipoIdentificacion: string;
+    numeroIdentificacion: string;
+  };
+  receptor: {
+    tipoIdentificacion: string;
+    numeroIdentificacion: string;
+  };
+  comprobanteXml: string;
+  consecutivoReceptor?: string;
+};
+
 export type Command = {
   url: string;
   method: Method;
-  data: {
-    clave: string;
-    fecha: string;
-    emisor: {
-      tipoIdentificacion: string;
-      numeroIdentificacion: string;
-    };
-    receptor: {
-      tipoIdentificacion: string;
-      numeroIdentificacion: string;
-    };
-    comprobanteXml: string;
-  };
+  data: CommandData;
   headers: {
     Authorization: string;
     'Content-Type': string;

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

@@ -0,0 +1,121 @@
+import { AceptationStates, ReceptorMessageProps } from "@src/ATV/core/types";
+import { mapReceptorMessageToAtvFormat } from "@src/ATV/mappers/billDocToAtv";
+import { genXML, parseElectronicBillXML } from "@src/lib/genXML";
+import { Command } from "../createDocument/types";
+import { ATV } from "@src/ATV";
+import { ReceptorConsecutive } from "@src/ATV/core/ReceptorConsecutive";
+
+export type CreateReceptorMessageCommandInput = {
+    receivedDocument: string;
+    aceptationState: AceptationStates;
+    aceptationDetailMessage: string;
+    branch: string;
+    terminal: string;
+    token: string;
+    consecutive: string;
+    signatureOptions: {
+        buffer: string;
+        password: string;
+    };
+}
+
+const options: { [key: string]: { serviceUrl: string}} = {
+    prod: {
+      serviceUrl: 'https://api.comprobanteselectronicos.go.cr/v1/recepcion'
+    },
+    stg: {
+      serviceUrl: 'https://api-sandbox.comprobanteselectronicos.go.cr/recepcion/v1/recepcion'
+    }
+  }
+
+export class CreateReceptorMessageCommand {
+    private readonly serviceUrl: string
+
+    constructor(scope: ATV) {
+        this.serviceUrl = options[scope.mode].serviceUrl
+    }
+
+    public async execute(input: CreateReceptorMessageCommandInput) {
+        const receptorMessageProps = this.processDocument(input)
+        const atvDocument = mapReceptorMessageToAtvFormat(receptorMessageProps)
+        const xml = await genXML('MensajeReceptor', atvDocument, input.signatureOptions)
+        const command = await this.createDocumentCommand(receptorMessageProps, xml, input.token)
+        return {
+            command,
+            extraData: {
+              xml,
+              document: atvDocument
+            }
+        }
+    }
+
+    private async createDocumentCommand(receptorMessageProps: ReceptorMessageProps, xml: string, token: string): Promise<Command> {
+        return {
+          url: this.serviceUrl,
+          method: 'post',
+          data: {
+            clave: receptorMessageProps.clave,
+            fecha: receptorMessageProps.documentIssueDate.toISOString(),
+            emisor: {
+              tipoIdentificacion: receptorMessageProps.emitterIdentifierType,
+              numeroIdentificacion: receptorMessageProps.emitterIdentifier,
+            },
+            receptor: {
+              tipoIdentificacion: receptorMessageProps.receptorIdentifierType,
+              numeroIdentificacion: receptorMessageProps.receptorIdentifier,
+            },
+            comprobanteXml: this.encodeXML(xml),
+            consecutivoReceptor: receptorMessageProps.receptorConcecutive
+          },
+          headers: {
+            Authorization: 'bearer ' + token,
+            'Content-Type': 'application/json'
+          }
+        }
+    }
+
+    private encodeXML(xmlStr: string): string {
+        const buffer = Buffer.from(xmlStr)
+        return buffer.toString('base64')
+    }
+
+    private acceptationStateToDocumentType(aceptationState: AceptationStates) {
+      switch (aceptationState) {
+        case AceptationStates.ACCEPTED:
+          return '05'
+        case AceptationStates.PARTIALLY_ACCEPTED:
+          return '06'
+        default:
+          return '07'
+      }
+    }
+
+    private processDocument(input: CreateReceptorMessageCommandInput): ReceptorMessageProps {
+        try {
+            const electronillBillRaw = parseElectronicBillXML(input.receivedDocument)
+            const receptorConsecutive = ReceptorConsecutive.create({
+              branch: input.branch,
+              terminal: input.terminal,
+              documentType: this.acceptationStateToDocumentType(input.aceptationState),
+              consecutive: input.consecutive,
+            })
+            return {
+                clave: electronillBillRaw.Clave,
+                emitterIdentifier: electronillBillRaw.Emisor.Identificacion.Numero,
+                emitterIdentifierType: electronillBillRaw.Emisor.Identificacion.Tipo,
+                receptorIdentifier: electronillBillRaw.Receptor.Identificacion.Numero,
+                receptorIdentifierType: electronillBillRaw.Receptor.Identificacion.Tipo,
+                documentIssueDate: new Date(electronillBillRaw.FechaEmision),
+                activityCode: electronillBillRaw.CodigoActividad,
+                taxCondition: electronillBillRaw.CondicionVenta,
+                totalTaxes: electronillBillRaw.ResumenFactura.TotalImpuesto,
+                totalSale:  electronillBillRaw.ResumenFactura.TotalVenta,
+                aceptationState: input.aceptationState,
+                aceptationDetailMessage: input.aceptationDetailMessage,
+                receptorConcecutive: receptorConsecutive.value
+            }
+        } catch (err) {
+            throw new Error('Error parsing the document')
+        }
+    }
+}

package/src/confirmXML.ts

@@ -1,5 +1,5 @@
 import { consecutivoStr } from '@src/lib/genClave'
-import { xmlToJson, genXML } from '@src/lib/genXML/index'
+import { parseElectronicBillXML, genXML } from '@src/lib/genXML/index'
 import { send } from '@src/services/send/index'
 import { getFinalMessage, getMsjObj } from '@src/lib/genJSON/confirmXML'
 
@@ -21,7 +21,7 @@ export default async (opts: {
 }): Promise<any> => {
   const { token, pemOpt, tipoDocKey } = opts
   const consecutivo = getConsecutivoStr(opts)
-  const fullInvoice = xmlToJson(opts.xmlStr)
+  const fullInvoice = parseElectronicBillXML(opts.xmlStr)
   const msjObj = getMsjObj({ fullInvoice, consecutivo, tipoDocKey })
   const xmlBase64 = await genXML(tipoDocKey, msjObj, {
     buffer: pemOpt.buffer,

package/src/electronicBill.ts

@@ -2,9 +2,10 @@ import { ClientPayload, FinalMessagePerson } from '@src/types/globalInterfaces'
 import { genClaveObj, genString, parseOptions } from '@src/lib/genClave/index'
 import genJSON from '@src/lib/genJSON/index'
 import { send } from '@src/services/send/index'
+import { Persona } from './types/facturaInterfaces'
 
 const DEFAULT_VALUES = {
-  tipoIdentificacion: '01'
+  tipoIdentificacion: '01' as Persona['Identificacion']['Tipo']
 }
 
 const encodeXML = (xmlStr: string): string => {

package/src/helpers/comprobantes.ts

@@ -6,7 +6,7 @@ const DEFAULT_VALUES = {
   message: 'Default msj',
   detailsMessage: 'Default details msj',
   taxes: 100,
-  tipoIdentificacion: '01'
+  tipoIdentificacion: '01' as Persona['Identificacion']['Tipo']
 }
 
 export function getSimpleSender(frontEndRequest: ClientPayload): FinalMessagePerson {

package/src/index.ts

@@ -1,4 +1,4 @@
-
+export { parseElectronicBillXML as xmlToJson } from './lib/genXML'
 export { Document, InvoiceDocumentContainer, DetalleServicio, Resumen, Persona } from './types/facturaInterfaces'
 export { CreateDocumentInput } from './ATV/core/CreateDocFactory'
 export { ATV } from './ATV'

package/src/lib/genJSON/confirmXML.ts

@@ -31,17 +31,17 @@ export function getMsjObj(opts: {
 export function getFinalMessage(fullInvoice: any, consecutivoReceptor: string, xmlBase64: any): any {
   const date = new Date()
   return {
-    clave: fullInvoice.Clave,
-    fecha: date.toISOString(),
-    emisor: {
+    clave: fullInvoice.Clave, // in command
+    fecha: date.toISOString(), // in command
+    emisor: { // in command
       tipoIdentificacion: fullInvoice.Receptor.Identificacion.Tipo,
       numeroIdentificacion: fullInvoice.Receptor.Identificacion.Numero
     },
-    receptor: {
+    receptor: { // in command
       tipoIdentificacion: fullInvoice.Emisor.Identificacion.Tipo,
       numeroIdentificacion: fullInvoice.Emisor.Identificacion.Numero
     },
     consecutivoReceptor,
-    comprobanteXml: xmlBase64
+    comprobanteXml: xmlBase64 // in command
   }
 }

package/src/lib/genJSON/index.ts

@@ -7,7 +7,7 @@ const DEFAULT_VALUES = {
   key: 0,
   message: 'Default msj',
   detailsMessage: 'Default details msj',
-  tipoIdentificacion: '01'
+  tipoIdentificacion: '01' as Persona['Identificacion']['Tipo']
 }
 
 function sumLines(lines: LineaDetalle[]): any {

package/src/lib/genXML/index.ts

@@ -1,6 +1,7 @@
 import { j2xParser, parse } from 'fast-xml-parser'
 import { declaration, defaultOptions, xmlExtructures } from '@src/lib/genXML/xmlConfig'
 import sigXML from '@src/lib/genXML/sigXML/index'
+import { XMLRawDocument } from '@src/types/facturaInterfaces'
 
 export const objToXML = (xmlStructure: string, obj: object): string => {
   const parser = new j2xParser(defaultOptions) // eslint-disable-line new-cap
@@ -21,7 +22,7 @@ export async function genXML(xmlStructure: string, obj: object, options?: {
   return signedXML
 }
 
-export const xmlToJson = (xml: string): any => {
+export const parseElectronicBillXML = (xml: string): XMLRawDocument => {
   try {
     const json = parse(xml, {
       ignoreAttributes: false,

package/src/types/facturaInterfaces.ts

@@ -51,7 +51,7 @@ export interface Resumen {
 export interface Persona {
   Nombre: string;
   Identificacion: {
-    Tipo?: string;
+    Tipo?: '01' | '02';
     Numero: string;
   };
   NombreComercial?: string;
@@ -104,8 +104,27 @@ export interface Document {
   InformacionReferencia?: InformacionReferencia;
 }
 
+export interface XMLRawDocument extends Document {
+
+}
+
+interface MensajeReceptor {
+  Clave: string;
+  NumeroCedulaEmisor: string;
+  FechaEmisionDoc: string;
+  Mensaje: string;
+  DetalleMensaje: string;
+  MontoTotalImpuesto: number;
+  CodigoActividad: string;
+  CondicionImpuesto: string;
+  MontoTotalDeGastoAplicable: number;
+  TotalFactura: number;
+  NumeroCedulaReceptor: string;
+  NumeroConsecutivoReceptor: string;
+}
+
 export interface InvoiceDocumentContainer {
-  [key: string]: Document;
+  [key: string]: Document | MensajeReceptor;
 }
 
 export type ConfirmationMessageRaw = {

package/examples/confirmXML.ts

@@ -1,76 +0,0 @@
-import confirmXML from '@src/confirmXML'
-import { sendToCustomURL } from '@src/services/send/index'
-import getToken from '@src/services/getToken'
-import fs from 'fs'
-
-const USERNAME_TEST = process.env.USERNAME_TEST
-const PASSWORD_TEST = process.env.PASSWORD_TEST
-
-const SOURCE_P12_URI = process.env.SOURCE_P12_URI
-const SOURCE_P12_PASSPORT = process.env.SOURCE_P12_PASSPORT
-const XML_TO_CONFIRM = process.env.XML_TO_CONFIRM
-
-function decodeBase64(encodedStr: string): string {
-  const buff = Buffer.from(encodedStr, 'base64')
-  return buff.toString('ascii')
-}
-
-function getConfimation(token: string, data: any, ms: number): Promise<any> {
-  return new Promise((resolve, reject): any => {
-    setTimeout(() => {
-      const location = data.headers.location
-      console.log('location', location)
-      sendToCustomURL(token, location)
-        .then(data => resolve(data))
-        .catch(err => reject(err))
-    }, ms)
-  })
-}
-
-async function main(): Promise<void> {
-  try {
-    const pem = fs.readFileSync(SOURCE_P12_URI, 'binary')
-    const xml = fs.readFileSync(XML_TO_CONFIRM, 'utf-8')
-    const token = await getToken({
-      client_id: 'api-stag', // eslint-disable-line
-      client_secret: '', // eslint-disable-line
-      grant_type: 'password', // eslint-disable-line
-      username: USERNAME_TEST,
-      password: PASSWORD_TEST
-    })
-    const consecutivo = {
-      consecutivo: '0000000013'
-    }
-    const data = await confirmXML({
-      token: token.data.access_token,
-      consecutivo,
-      xmlStr: xml,
-      tipoDocKey: 'CCE',
-      pemOpt: {
-        buffer: pem,
-        password: SOURCE_P12_PASSPORT
-      }
-    })
-    if (data) {
-      const secondResponse = await getConfimation(token.data.access_token, data, 10000)
-        .catch(err => {
-          const response = err.response || {}
-          console.log('response', response)
-        })
-      const XMLResponse = secondResponse.data['respuesta-xml']
-      if (!XMLResponse) {
-        const state = secondResponse.data['ind-estado']
-        console.log('state', state)
-        return
-      }
-      const text = decodeBase64(XMLResponse)
-      console.log('secondResponse', text)
-    } else {
-      console.log('no data', data)
-    }
-  } catch (error) {
-    console.warn(error.code)
-  }
-}
-
-main()