FYGARO ONE Documentación API

Transcripción

1 FYGARO ONE Documentación API Abril 2018

2 ÍNDICE Este documento tiene como objetivo guiarlo en el proceso de integración al nuevo régimen de facturación electrónica utilizando FYGARO ONE. Para lograr este objetivo, incluimos los siguientes capítulos: 1. Información General. 2. Endpoints. 3. Recomendaciones. Importante: Este documento, su distribución y uso deben limitarse a su objetivo principal: ser una herramienta de apoyo para la integración a la plataforma. Este documento se debe compartir y utilizar mediante prácticas que respeten la confidencialidad de la información que contiene.

3 INFORMACIÓN GENERAL Bajo la nueva regulación, la factura electrónica no es una representación gráfica, impresión ni pdf; sino un archivo xml que cumple con detalladas especificaciones técnicas y de seguridad detalladas en la nueva regulación. Con FYGARO ONE, el proceso de integración es fácil. Mediante una pequeña integración, su sistema adquirirá la capacidad de crear y emitir documentos electrónicos, enviarlos por correo (en conjunto con su representación gráfica) y automáticamente respaldarlos en nuestros servidores seguros. Previo a entrar en materia técnica, es importante entender el proceso o flujo por utilizar: 1. Lo primero es enviar a FYGARO la información básica del documento electrónico que desea emitir o recibir. 2. FYGARO generará el documento usando la información recibida. Dicho documento le será retornado inmediatamente. 3. FYGARO procederá a enviar el documento al Ministerio de Hacienda. 4. FYGARO se mantendrá a la espera de la aprobación o rechazo de este documento por parte de Hacienda. Por regulación, el Ministerio tiene hasta 5 días para responder. 5. Una vez tenemos un resultado por parte del Ministerio, utilizaremos el callback configurado para notificar a su sistema del resultado. Adicional a los pasos anteriores, en caso que la factura incluya un receptor, FYGARO le permite enviar la factura por correo a él automáticamente. Esto sucede simultáneo al punto 3.

4 ENDPOINTS Gracias a FYGARO, todo el trabajo de emitir y recibir documentos electrónicos y administrar sus respaldos, se reduce a una integración de 3 pasos: 1. Autenticación. 2. Creación o Recepción de Documento. 3. Obtener Respaldo de Documento. URLs Utilice las siguientes direcciones como el host de las consultas a realizar. SANDBOX: sandbox.fygaro.one PRODUCCIÓN: api.fygaro.one

5 AUTENTICACIÓN OBTENER TOKEN: /api/v1/auth/obtener-token/ [POST] Para poder acceder al API, debe primero obtener un token utilizando las credenciales obtenidas a través del portal administrativo. REQUEST BODY [string] api_key: Código obtenido desde portal administrativo de credenciales. [string] api_secret: Código obtenido desde portal administrativo de credenciales. Ejemplo: api_key : CÓDIGO", api_secret : CÓDIGO RESPONSE [string] token: JWT generado. Este código deberá ser incluido en el header de los requests a los endpoints seguros para poder utilizarlos. Ejemplo: token": CÓDIGO

6 REFRESCAR TOKEN: /api/v1/auth/refrescar-token/ [POST] Los tokens de acceso tienen una fecha de expiración por su seguridad. Si desea obtener un nuevo token sin la necesidad de utilizar las credenciales nuevamente, utilice este endpoint mientras el token anterior siga vigente. REQUEST HEADER [string] Authorization: Bearer + JWT obtenido previamente. Ejemplo: Authorization : Bearer [CÓDIGO] REQUEST BODY No requiere ningún valor adicional. RESPONSE [string] token: nuevo JWT generado. Ejemplo: token : CÓDIGO

7 CREACIÓN Y RECEPCIÓN DE DOCUMENTOS FACTURA ELECTRÓNICA: /api/v1/factura-electronica/ [POST] TIQUETE ELECTRÓNICO: /api/v1/tiquete-electronico/ [POST] Utilice este endpoint para emitir una nueva factura electrónica o tiquete electrónico según requiera. REQUEST HEADER [string] Authorization: Bearer + JWT obtenido previamente. Authorization : Bearer CÓDIGO REQUEST BODY [requerido][string] fecha_emision: Fecha de creación del documento en formato ISO 8601 (YYYY-MM-DDThh:mm). Más información en: [requerido][integer] numero_consecutivo: Número consecutivo del documento. [string] referencia_externa: Código opcional, no incluido a Hacienda, que FYGARO ONE retornará en respuestas, consultas y/o callbacks futuros que hagan referencia a este documento. [integer] local_comercial: Identificador local comercial que emite el documento. Este dato será utilizado para crear el consecutivo único del documento. Este número es definido por cada empresa para uso discrecional, no corresponde a ningún indicador externo. (Default: 1) [integer] punto_venta: Identificador del punto de venta que emite el documento. Este dato será utilizado para crear el consecutivo único del documento. Este número es definido por cada empresa para uso discrecional, no corresponde a ningún indicador externo. (Default: 1) [integer] condición_venta: Las opciones disponibles son: (Default: 1) Contado 1 Arrendamiento con opción de compra 5 Crédito 2 Arrendamiento en funcion 6

8 Consignacion 3 Otros 99 Apartado 4 [string][max-length: 10] plazo_credito: Campo que describe el plazo del crédito dado. Este campo solo será obligatorio cuando el campo de la condición de venta indique crédito. [string][max-length: 10] plazo_credito: Campo que describe el plazo del crédito dado. Este campo solo será obligatorio cuando el campo de la condición de venta indique crédito. [array of integers][max items: 4] medios_pago: Recibe una lista que describe los medios de pago utilizados. Por regulación, si no se conoce el medio de pago a la hora de emitir el documento se debe colocar la opción para Efectivo. (Default: [1]) Efectivo 1 Transferencia o Depósito 4 Tarjeta 2 Recaudado por Terceros 5 Cheque 3 Otros 99 [recomendado][object] receptor: Este campo define al receptor del documento electrónico. Nota: Si un documento no incluye receptor, este no podrá aceptarlo de forma electrónica. Si su receptor es un receptor electrónico, se recomienda incluir este objeto y la propiedad numero_identificación para evitar inconvenientes. PROPIEDADES DEL OBJETO: RECEPTOR [requerido][string][max-length: 80] razon_social: Nombre legal del receptor. [string] numero_identificacion: Número del documento legal de identificación. [integer] tipo_identificacion: Identificador que describe el tipo de documento utilizado en el campo anterior. (Es requerido en caso de incluir numero_identificación). Opciones: (1) Cédula Física (2) Cédula Jurídica (3) DIMEX (4) NITE [string] identificacion_extranjero: Número del documento legal de identificación en caso de que el receptor sea extranjero. [string][max-length: 80] nombre_comercial: Nombre comercial del receptor. [string] telefono: Teléfono de contacto del receptor. [string] fax: Fax de contacto del receptor.

9 [integer] provincia: Provincia en la que se encuentra registrado el receptor. Ver Anexo A. [integer] canton: Provincia en la que se encuentra registrado el receptor. Ver opciones en anexo A. [integer] distrito: Provincia en la que se encuentra registrado el receptor. Ver opciones en anexo A. [integer] barrio: Provincia en la que se encuentra registrado el receptor. Ver opciones en anexo A. [string][max-length: 160] otras_senas: Indicaciones adicionales respecto a la localización del receptor. [string] correo: de contacto para el receptor (solo 1). Este campo se puede utilizar para el envío del correo y también será incluido en el XML como parte de la información del receptor. [array(string)] cc: Esta lista solo se utilizaría para efectos del envío, no se incluye en el XML. [array(string)] bcc: Esta lista solo se utilizaría para efectos del envío, no se incluye en el XML. [boolean] enviar_correo: Enviar Documento por . En caso de ser True, es requerido al menos 1 de los campos: , cc o bcc. (Default: False). [requerido][array of objects] detalle_mercancia: Lista de la mercancia que compone este documento electrónico. PROPIEDADES DEL OBJETO: DETALLE_MERCANCÍA [string][max-length: 20] codigo: Código identificador del documento. [integer] tipo_codigo: Identificador que describe el tipo de código utilizado en el campo anterior. Es decir, quien asignó dicho código. Opciones: (1) Código del Vendedor (2) Código del Comprador (3) Código de la Industria (4) Código de Uso Interno (99) Otros [requerido][string][max-length: 160] detalle: Texto que describe la mercancia. [requerido][decimal][max-length: 18,5] precio_unitario: Precio unitario de la mercancía. (Default: 1) [decimal][max-length: 18,2] monto_descuento: Monto descontado. (Default: 1). [string][max-length: 80] naturaleza_descuento: Razón del descuento. (Es requerido si existe descuento).

10 [decimal][max-length: 16,3] cantidad: Identificador que describe el tipo de código utilizado en el campo anterior. Es decir, quien asignó dicho código. (Default: 1) [integer] unidad_medida: Define la unidad de medida utilizada en el campo de cantidad. Ver opciones en Anexo A. [boolean] servicio: Verdadero en caso de que la mercancía sea de tipo servicio. (Default: False) [array of objects] impuestos: Lista de impuestos aplicables a esta mercancía. PROPIEDADES DEL OBJETO: IMPUESTOS [requerido][integer] codigo: Identificador que describe el tipo de impuesto por aplicar. Opciones: (1) Impuesto General sobre las Ventas (2) Impuesto Selectivo de Consumo (3) Impuesto Único a los Combustibles (4) Impuesto Específico de Bebidas Alcohólicas (5) Impuesto Específico sobre las Bebidas Envasadas sin Contenido Alcohólico y Jabones de Tocador (6) Impuesto a los Productos de Tabaco (7) Impuesto de Servicio (12) Impuesto Específico al Cemento (98) Otros [requerido][decimal][max-length: 4,2] tarifa: Porcentaje del impuesto por aplicar. [object] exoneracion: Descripción de exoneración aplicada a esta mercancía. PROPIEDADES DEL OBJETO: EXONERACIÓN [requerido][string] numero_documento: Número del documento legal al cuál aplica la exoneración. [requerido][integer] tipo_documento: Identificador que describe el tipo de documento utilizado en el campo anterior. (1) Compras Autorizadas (2) Ventas a Diplomáticos (3) Ventas a Instituciones Públicas y Organismos (4) Exenciones Dirección General de Hacienda (5) Zonas Francas (99) Otros [requerido][string][max-length: 100] nombre_institucion: Nombre de la institución.

11 [requerido][decimal][max-length: 18,5] monto_impuesto: Monto del impuesto exonerado. [requerido][integer] porcentaje_compra: Porcentaje que representa el monto exonerado del total de la compra. [requerido][datetime] fecha_emision: Fecha de Emisión del Documento de Exoneración. [string] codigo_moneda: Moneda a utilizar en el documento (debe ser coherente con todos los valores correspondientes a montos de dinero enviados en esta transacción). Se debe indicar la moneda utilizando su código de 3 caracteres según convención ISO. Más información en: (Default: crc ) [decimal][max-length: 18,5] tipo_cambio: Tipo de cambio para referencia futura. Ejemplo Mínimo: "fecha_emision": ", "numero_consecutivo": 1", "detalle_mercancia": [ "precio_unitario": 1000", "detalle": Mercancia ABC, "cantidad": "3" ]

12 Ejemplo Regular: "fecha_emision": " ", "local_comercial": "3", "punto_venta": "2", "numero_consecutivo": 10", "referencia_externa": "FY-10" "medios_pago": [3], "receptor": "razon_social": Ejemplo S.A., "tipo_identificacion": 1, "numero_identificacion": " ", "detalle_mercancia": [ codigo : 1010, "precio_unitario": "100", "detalle": Servicio 123", "cantidad": "3", "servicio": true, codigo : 2010, "precio_unitario": "100", "detalle": Producto 123", "cantidad": "1", "servicio": false, "impuestos": [ "codigo": "1", "tarifa": "13" ] ]

13 NOTAS DE CRÉDITO: /api/v1/nota-credito/ [POST] NOTAS DE DÉBITO: /api/v1/nota-debito/ [POST] Utilice este endpoint para emitir una nueva nota de crédito o débito según requiera. REQUEST HEADER [string] Authorization: Bearer + JWT obtenido previamente. Authorization : Bearer CÓDIGO REQUEST BODY [requerido][string] fecha_emision: Fecha de creación del documento en formato ISO 8601 (YYYY-MM-DDThh:mm). Más información en: [requerido][integer] numero_consecutivo: Número consecutivo del documento. [string] referencia_externa: Código opcional, no incluido a Hacienda, que FYGARO ONE retornará en respuestas, consultas y/o callbacks futuros que hagan referencia a este documento. [integer] local_comercial: Identificador local comercial que emite el documento. Este dato será utilizado para crear el consecutivo único del documento. Este número es definido por cada empresa para uso discrecional, no corresponde a ningún indicador externo. (Default: 1) [integer] punto_venta: Identificador del punto de venta que emite el documento. Este dato será utilizado para crear el consecutivo único del documento. Este número es definido por cada empresa para uso discrecional, no corresponde a ningún indicador externo. (Default: 1) [integer] condición_venta: Las opciones disponibles son: (Default: 1) Contado 1 Arrendamiento con opción de compra 5 Crédito 2 Arrendamiento en funcion 6 Consignacion 3 Otros 99 Apartado 4

14 [requerido][string] clave_documento_referencia: Clave del documento al cual está nota hace referencia. Dicha clave corresponde al numero de 50 dígitos el cual es retornado en el envío o creación de cada documento. [requerido][string] fecha_emision_documento_referencia: Fecha de emisión del documento al cual está nota hace referencia. [requerido][integer] tipo_documento_referencia: Tipo del documento al cual está nota hace referencia. Las opciones disponibles son: Factura Electrónica 1 Nota de Débito 2 Nota de Crédito 3 Tiquete Electrónico 4 Confirmación de Aceptación del Comprobante Confirmación de Aceptación Parcial del Comprobante Confirmación del Rechazo del Comprobante [requerido][string] codigo_referencia: Código que identifica la relación entre la nota y el documento de referencia. Las opciones disponibles son: Anula Documento de Referencia 1 Referencia a otro documento 4 Corrige texto documento de referencia 2 Sustituye comprobante provisional por contingencia 5 Corrige monto 3 Otros 99 [requerido][string][max-length: 80] razon: Campo solicitado por hacienda que describe la razón de emitir este nuevo documento. [string][max-length: 10] plazo_credito: Campo que describe el plazo del crédito dado. Este campo solo será obligatorio cuando el campo de la condición de venta indique crédito. [string][max-length: 10] plazo_credito: Campo que describe el plazo del crédito dado. Este campo solo será obligatorio cuando el campo de la condición de venta indique crédito.

15 [array of integers][max items: 4] medios_pago: Recibe una lista que describe los medios de pago utilizados. Por regulación, si no se conoce el medio de pago a la hora de emitir el documento se debe colocar la opción para Efectivo. (Default: [1]) Efectivo 1 Transferencia o Depósito 4 Tarjeta 2 Recaudado por Terceros 5 Cheque 3 Otros 99 [recomendado][object] receptor: Este campo define al receptor del documento electrónico. Nota: Si un documento no incluye receptor, este no podrá aceptarlo de forma electrónica. Si su receptor es un receptor electrónico, se recomienda incluir este objeto y la propiedad numero_identificación para evitar inconvenientes. PROPIEDADES DEL OBJETO: RECEPTOR [requerido][string][max-length: 80] razon_social: Nombre legal del receptor. [string] numero_identificacion: Número del documento legal de identificación. [integer] tipo_identificacion: Identificador que describe el tipo de documento utilizado en el campo anterior. (Es requerido en caso de incluir numero_identificación). Opciones: (1) Cédula Física (2) Cédula Jurídica (3) DIMEX (4) NITE [string] identificacion_extranjero: Número del documento legal de identificación en caso de que el receptor sea extranjero. [string][max-length: 80] nombre_comercial: Nombre comercial del receptor. [string] telefono: Teléfono de contacto del receptor. [string] fax: Fax de contacto del receptor.

16 [integer] provincia: Provincia en la que se encuentra registrado el receptor. Ver opciones en anexo A. [integer] canton: Provincia en la que se encuentra registrado el receptor. Ver opciones en anexo A. [integer] distrito: Provincia en la que se encuentra registrado el receptor. Ver opciones en anexo A. [integer] barrio: Provincia en la que se encuentra registrado el receptor. Ver opciones en anexo A. [string][max-length: 160] otras_senas: Indicaciones adicionales respecto a la localización del receptor. [string] de contacto para el receptor (solo 1). Este campo se puede utilizar para el envío del correo y también será incluido en el XML como parte de la información del receptor. [array(string)] cc: Esta lista solo se utilizaría para efectos del envío, no se incluye en el XML. [array(string)] bcc: Esta lista solo se utilizaría para efectos del envío, no se incluye en el XML. [boolean] enviar_correo: Enviar Documento por . En caso de ser True, es requerido al menos 1 de los campos: correo, cc o bcc. (Default: False). [requerido][array of objects] detalle_mercancia: Lista de la mercancia que compone este documento electrónico. PROPIEDADES DEL OBJETO: DETALLE_MERCANCÍA [string][max-length: 20] codigo: Código identificador del documento. [integer] tipo_codigo: Identificador que describe el tipo de código utilizado en el campo anterior. Es decir, quien asignó dicho código. Opciones: (1) Código del Vendedor (2) Código del Comprador (3) Código de la Industria (4) Código de Uso Interno (99) Otros [requerido][string][max-length: 160] detalle: Texto que describe la mercancia. [requerido][decimal][max-length: 18,5] precio_unitario: Precio unitario de la mercancía. (Default: 1) [decimal][max-length: 18,2] monto_descuento: Monto descontado. (Default: 1) [string][max-length: 80] naturaleza_descuento: Razón del descuento. (Es requerido si existe descuento).

17 [decimal][max-length: 16,3] cantidad: Identificador que describe el tipo de código utilizado en el campo anterior. Es decir, quien asignó dicho código. (Default: 1) [integer] unidad_medida: Define la unidad de medida utilizada en el campo de cantidad. Ver opciones en Anexo A. [boolean] servicio: Verdadero en caso de que la mercancía sea de tipo servicio. (Default: False) [array of objects] impuestos: Lista de impuestos aplicables a esta mercancía. PROPIEDADES DEL OBJETO: IMPUESTOS [requerido][integer] codigo: Identificador que describe el tipo de impuesto por aplicar. Opciones: (1) Impuesto General sobre las Ventas (2) Impuesto Selectivo de Consumo (3) Impuesto Único a los Combustibles (4) Impuesto Específico de Bebidas Alcohólicas (5) Impuesto Específico sobre las Bebidas Envasadas sin Contenido Alcohólico y Jabones de Tocador (6) Impuesto a los Productos de Tabaco (7) Impuesto de Servicio (12) Impuesto Específico al Cemento (98) Otros [requerido][decimal][max-length: 4,2] tarifa: Porcentaje del impuesto por aplicar. [object] exoneracion: Descripción de exoneración aplicada a esta mercancía. PROPIEDADES DEL OBJETO: EXONERACIÓN [requerido][string] numero_documento: Número del documento legal al cuál aplica la exoneración. [requerido][integer] tipo_documento: Identificador que describe el tipo de documento utilizado en el campo anterior. (1) Compras Autorizadas (2) Ventas a Diplomáticos (3) Ventas a Instituciones Públicas y Organismos (4) Exenciones Dirección General de Hacienda (5) Zonas Francas (99) Otros [requerido][string][max-length: 100] nombre_institucion: Nombre de la institución.

18 [requerido][decimal][max-length: 18,5] monto_impuesto: Monto del impuesto exonerado. [requerido][integer] porcentaje_compra: Porcentaje que representa el monto exonerado del total de la compra. [requerido][datetime] fecha_emision: Fecha de Emisión del Documento de Exoneración. [string] codigo_moneda: Moneda a utilizar en el documento (debe ser coherente con todos los valores correspondientes a montos de dinero enviados en esta transacción). Se debe indicar la moneda utilizando su código de 3 caracteres según convención ISO. Más información en: (Default: crc ) [decimal][max-length: 18,5] tipo_cambio: Tipo de cambio para referencia futura. Ejemplo Mínimo: "tipo_documento_referencia": 01, "clave_documento_referencia": ", "fecha_emision_documento_referencia": ", "codigo_referencia": 01, "razon": Emitida por error., "fecha_emision": , "numero_consecutivo": 1", "detalle_mercancia": [ "precio_unitario": 1000", "detalle": Mercancia ABC, "cantidad": "3" ]

19 Ejemplo Regular: "tipo_documento_referencia": 01, "clave_documento_referencia": ", "fecha_emision_documento_referencia": ", "codigo_referencia": 01, "razon": Emitida por error., "fecha_emision": , "local_comercial": "3", "punto_venta": "2", "numero_consecutivo": "11", "referencia_externa": "N-10" "medios_pago": [3], "receptor": "razon_social": Ejemplo S.A., "tipo_identificacion": 1, "numero_identificacion": " ", "detalle_mercancia": [ codigo : 1010, "precio_unitario": "100", "detalle": Servicio 123", "cantidad": "3", "servicio": true, codigo : 2010, "precio_unitario": "100", "detalle": Producto 123", "cantidad": "1", "servicio": false, "impuestos": [ "codigo": "1", "tarifa": "13" ] ]

20 MENSAJE DE RECEPCIÓN: /api/v1/mensaje-recepcion/ [POST] [MULTIPART O JSON] Utilice este endpoint para emitir la confirmación o rechazo de documentos (Factura Electrónica, Tiquete Electrónico, Nota de Débito o Nota de Crédito). REQUEST HEADER [string] Authorization: Bearer + JWT obtenido previamente. Authorization : Bearer CÓDIGO REQUEST BODY [requerido][file o string] documento_xml: Documento (Factura Electrónica, Tiquete Electrónico, Nota de Débito o Nota de Crédito) en formato XML, el cual se desea aceptar o rechazar. Notas: - Si el request se envía en formato multipart, el valor de este campo debe ser de tipo File - Si el request se envía en formato JSON, el valor de este campo debe ser un string codificado en base64. [requerido][integer] tipo_mensaje: Código que representa la respuesta que desea enviar a la Dirección General de Tributación, sobre el documento recibido: Aceptado 1 Pacialmente Aceptado 2 Rechazado 3 [string] referencia_externa: Código opcional, no incluido a Hacienda, que FYGARO ONE retornará en respuestas, consultas y/o callbacks futuros que hagan referencia a este documento. [integer] numero_consecutivo: Número consecutivo del documento, En caso de no colocar este valor, automáticamente se enviará un consecutivo interno del sistema.

21 [integer] local_comercial: Identificador local comercial que emite el documento. Este dato será utilizado para crear el consecutivo único del documento. Este número es definido por cada empresa para uso discrecional, no corresponde a ningún indicador externo. (Default: 1) [integer] punto_venta: Identificador del punto de venta que emite el documento. Este dato será utilizado para crear el consecutivo único del documento. Este número es definido por cada empresa para uso discrecional, no corresponde a ningún indicador externo. (Default: 1) [string] correo: de contacto para el emisor (solo 1). Este campo se utilizará solo para el envío de la confirmación por correo. No tiene implicación sobre el XML. [array(string)] cc: Este campo se utilizará solo para el envío de la confirmación por correo. No tiene implicación sobre el XML. [array(string)] bcc: Este campo se utilizará solo para el envío de la confirmación por correo. No tiene implicación sobre el XML. [boolean] enviar_correo: Enviar Documento por . En caso de ser True, es requerido al menos 1 de los campos: correo, cc o bcc. (Default: False). Ejemplo Mínimo: "documento_xml": File o Base64(String), "tipo_mensaje": 1 Ejemplo Regular: "documento_xml": File o Base64(String), "tipo_mensaje": 1, local_comercial : 1, punto_venta : 1, numero_consecutivo : 1, referencia_externa : MSG-01, correo : test@fygaro.com", cc : [ test1@fygaro.com", test2@fygaro.com"] enviar_correo : true

22 OBTENER RESPALDO DE DOCUMENTO Utilice los siguientes endpoints para obtener el documento electrónico en formato XML, enviado a la Dirección General de Tributación. FACTURA ELECTRÓNICA: /api/v1/factura-electronica/<clave>/ [GET] /api/v1/factura-electronica/referencia-externa/<referencia>/[get] TIQUETE ELECTRÓNICO: /api/v1/tiquete-electronico/<clave>/ [GET] /api/v1/tiquete-electronico/referencia-externa/<referencia>/[get] NOTA DÉBITO /api/v1/nota-debito/<clave>/ [GET] /api/v1/nota-debito/<referencia>/[get] NOTA CRÉDITO /api/v1/nota-credito/<clave>/ [GET] /api/v1/nota-credito/<referencia>/[get] MENSAJE RECEPCIÓN /api/v1/mensaje-recepcion/<clave>/ [GET] /api/v1/mensaje-recepcion/<referencia>/[get] PARÁMETROS URL [string] clave: Clave del documento sobre el cual desea obtener su respaldo. Dicha clave corresponde al numero de 50 dígitos el cual es retornado en el envío o creación de cada documento. [string] referencia: Corresponde al valor de la referencia externa colocada en la creación o envío de cada documento. REQUEST HEADER [string] Authorization: Bearer + JWT obtenido previamente. Authorization : Bearer CÓDIGO

23 RESPONSE BODY [string] referencia_externa: Código opcional del documento el cual no es incluido a Hacienda, y que FYGARO ONE retornará en respuestas, consultas y/o callbacks futuros que hagan referencia a este documento. [string] clave: Clave única del documento, la cual cumple con la regulaciones de Hacienda y es utilizada para identificar el documento ante este ente. [string] documento_xml: Valor codificado en base64, el cual contiene el documento en formato XML enviado a la Dirección General de Tributación. [integer] estado: Estado del documento consultado, las opciones disponibles son: Pendiente de Envío 1 Enviado 2 Aprobado 3 Aceptado Parcialmente 4 Rechazado 5 [string] estado_descripcion: Descripción breve del estado del documento. Hace referencia al valor del campo anterior. [string] respuesta_xml: Valor codificado en base64, el cual contiene en formato XML, la respuesta enviada por parte de la Dirección General de Tributación. [string] fecha_creacion: Fecha de Creación en el sistema del documento. Ejemplo Respuesta: referencia_externa": 001, "clave": , documento_xml : PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz, estado : 3, estado_descripcion : Aprobado, respuesta_xml : PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz, fecha_creacion : T18:38:01Z