Bienvenido!

Acatha Swagger UI. Te ayudara en la integración y configuración de las apis que se requieren para el funcionamiento de los módulos del ERP.

Aun no tienes registrado tu usuario?

Como usar Swagger Acatha


Nuestras apis se encuentran documentadas para cada solicitud. como objetos, parámetros, tipos de datos, campos requeridos o no requeridos, las apis que son de registros de datos muestran un esquema del objeto para la solicitud.

Las solicitudes request que corresponden a cada módulo necesita una autenticación a nivel de headers. Los headers que se solicitan en las request son:

  • authorization
  • client_id
  • secret_key
  • Session-ID
  • x-csrf-token

Las credenciales headers se los debe ingresar en el siguiente apartado


configuracion Headers

A continuación, se muestra una pantalla emergente donde se solicitan el ingreso de las credenciales headers.


configuracion Headers

Registro de Usuario


Registro de Usuario en AWS

Para registrar la cuenta de usuario lo debemos realizar desde el siguiente enlace Registrar Usuario desde el boton Regístrate ahora

configuracion Headers
Formulario de Registro

Completar los datos en el formulario, se debe utilizar el correo electronico con el que va a acceder a la cuenta.


configuracion Headers

Cuando ya se registra el usuario se envía un código de activación a la cuenta de correo que se ha ingresado en el formulario. Ingresar el código de activación en la siguiente pantalla.

configuracion Headers

Al activar la cuenta se le va a mostrar un mensaje de éxito, entonces ya se puede proceder a utilizar los endpoints acatha.


Login


Ingresar en AWS

Para lograr pasar la autenticación a través de los servicios rest se debe ejecutar previamente servicios rest que generan los recursos necesarios para la autenticación:

  • Obtener token para navegación request.
  • Validación de token
  • Autenticación a la empresa

Credencial Header del api


Para poder consumir las API es necesario contar con credenciales validas que son otorgadas por el equipo de desarrollo, si aún no cuenta con sus credenciales, puede realizar la solicitud de apertura de credenciales al siguiente correo (soporte@austrosoft.com.ec) solicitando las siguientes credenciales:

  • client_id
  • secret_key

para casos de pruebas se puede utilizar las credenciales:

'client_id: 2985313565',
'secret_key: N]SVp2*P8i8fRmWoU5OzNm97x5zlp9'
'Content-Type: application/json'

Variable tuServidor por defecto

tuServidor => https://dev.acatha.com

Obtener token para navegación request.

Este token es necesario para enviar en todas las solicitudes request, sin el token se rechazarán las peticiones.

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/cognito/#/Cognito/post_amfphp_services_SIGNUM_API_v4_cognito_login


API REST
Enlace del api: POST
{tuServidor}/amfphp/services/SIGNUM/API/v4/cognito/login

El api cognito/login retorna un objeto json en el que necesitamos capturar el keyName

Credenciales del api

Para poder consumir la API es necesario contar con credenciales validas, si aún no cuenta con sus credenciales, puede realizar la solicitud de apertura de credenciales al siguiente correo (soporte@austrosoft.com.ec) solicitando las siguientes credenciales:

  • client_id
  • secret_key

para casos de pruebas se puede utilizar las credenciales:

'client_id: 2985313565',
'secret_key: N]SVp2*P8i8fRmWoU5OzNm97x5zlp9'

Configuración de headers para las apis.

AcathaDoc Consumo Api Rest

Para consumir el api cognito/login se procede primeramente configurando los headers que requiere el api.

Configuración de headers
AcathaDoc

Una vez que ya se tenga configurado los headers que necesita el api. Se puede proceder a llenar el objeto que tiene el api para enviar la consulta.


Objeto para enviar en la solicitud
AcathaDoc
Objeto para enviar en la solicitud AcathaDoc
Respuesta request success

El resultado de esta consulta retorna el siguiente objeto


AcathaDoc

De este objeto necesitamos capturar el objeto keyName => IdToken, este objeto se necesita pasarlo en todas las request.


AcathaDoc
Api tipo de parámetros
NOMBRE TIPO DESCRIPCION DONDE OBTENER
user string

Credencial tipo usuario para acceder a la cuenta

Se emiten al crear la cuenta
pass string

Credencial tipo clave para acceder a la cuenta

Se emiten al crear la cuenta

Respuestas erróneas del api
AcathaDoc

Solucion: enviar los parámetros correctos de autenticación


La petición no ha sido ejecutada porque carece de credenciales válidas de autenticación. AcathaDoc

Solucion: enviar los parámetros correctos de configuración headers.

Validación de token


Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/index/#/%2Flogin%2FmailCheckout/get_amfphp_services_SIGNUM_API_v4_login_mailCheckout

Para pasar la validación del token se debe utilizar el api


Enlace del api: GET
{ tuServidor }/amfphp/services/SIGNUM/API/v4/login/mailCheckout

Configuración de headers, para validar el token se lo debe enviar en el header con el nombre del key => x-csrf-token y enviar el token que le genero el api de cognito/login.

Configuración de headers
AcathaDoc
Respuesta request success AcathaDoc

Si el api login/mailCheckout retorna en el objeto error como false, entonces se puede proceder con el siguiente api

Autenticación a la empresa


Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/index/#/%2Flogin%2Fautenticar/post_amfphp_services_SIGNUM_API_v4_login_autenticar

Para pasar la autenticación del token se debe utilizar el api

Enlace del api: GET
{ tuServidor }/amfphp/services/SIGNUM/API/v4/login/autenticar

Configuración de headers, para validar el token se lo debe enviar en el header x-csrf-token y enviar el token que le generó el api de cognito/login.

Configuración de headers AcathaDoc
Respuesta request success

Si la autenticación se ha realizado de forma correcta se le retornara el objeto que muestra la información del usuario, empresas con sus locales.

AcathaDoc
Respuesta request error

Posibles respuestas de error que pueden retornar

AcathaDoc
Código Descripción Solucion
401

La petición no ha sido ejecutada porque carece de credenciales válidas de autenticación.

Configurar los headers con las credenciales correctas.


Control de sesiones


Sesiones

El control de sesiones genera un header que se lo tiene que enviar en todas las solicitudes rest de los módulos Session-ID


Para controlar las sesiones de la empresa primeramente se debe verificar si esta activa la opción para este tipo de control. Se lo controla de acuerdo a los planes de cada empresa. En cada plan se tiene el key controlaSesiones

controlaSesiones => 0 -> inactivo, 1 -> activo

En el caso de tenerlo activado se puede controlar también el numero de dispositivos que pueden estar en sesión. Los keys de configuración son:


moviles => 0 sin limite
pc => 0 sin limite
tablet => 0 sin limite

Credenciales header del api

Para poder consumir las API es necesario contar con credenciales validas que son otorgadas por el equipo de desarrollo, si aún no cuenta con sus credenciales, puede realizar la solicitud de apertura de credenciales al siguiente correo (soporte@austrosoft.com.ec) solicitando las siguientes credenciales:


1) authorization => corresponde a tu empresa
2) client_id
3) secret_key

para casos de pruebas se puede utilizar las credenciales:


'authorization: 15y580dvCzHIM',
'client_id: 2985313565',
'secret_key: N]SVp2*P8i8fRmWoU5OzNm97x5zlp9'
'Content-Type: application/json'

Variable tuServidor por defecto


tuServidor => https://dev.acatha.com

Verificar Control de sesiones activo

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/index/#//sesion/config/get_amfphp_services_SIGNUM_API_v4_sesion_config


API REST
Enlace del api: GET
{ tuServidor }/amfphp/services/SIGNUM/API/v4/sesión/config

Respuesta request success
AcathaDoc
Verificar Control sesiones activas.

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/sessions/#/getSession/get_amfphp_services_SIGNUM_API_v4_sessions_getSession

Para verificar si tiene sesiones activa o sesión que no han sido cerradas desde otros dispositivos. Se debe hacer uso del api sessions/getSession


Configuración de los header

La authorization se la debe obtener del objeto empresas que le retorna el api de login/autenticar


'authorization: 15y580dvCzHIM',
'client_id: 2985313565',
'secret_key: N]SVp2*P8i8fRmWoU5OzNm97x5zlp9'
'x-csrf-token: token'

Parámetros de la solicitud
AcathaDoc
key

Descripción

De donde obtenerlo

dispositivo

Dispositivo desde donde hace la petición

pc, Tablet, movil.


Respuesta del api

El api le puede retornar un listado de sesiones activas para que desde una solicitud request se la pueda cerrar la sesión. Como también puede retornar que No existe una sesión activa, si es el caso que no existe una sesión activa se debe registrar la sesión para poder utilizar las apis de los módulos.


AcathaDoc

Si no existen sesiones se puede registrar una sesión para poner continuar con la secuencia de apis


AcathaDoc
Eliminar sesión

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/sessions/#/deactivate/delete_amfphp_services_SIGNUM_API_v4_sessions_deactivate


Para eliminar una sesión se debe utilizar el siguiente api sessions/deactivate y enviar en el id de la sesión que desea desactivar, se lo puede obtener del listado de sesiones que pudo obtener. identificadorSesion


Configuración de los header
'authorization: 15y580dvCzHIM',
'client_id: 2985313565',
'secret_key: N]SVp2*P8i8fRmWoU5OzNm97x5zlp9'
'x-csrf-token: token'

Parámetros de la solicitud
AcathaDoc
Respuesta de la solicitud
AcathaDoc
Cerrar todas las sesiones activas

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/sessions/#/deactivateAll/delete_amfphp_services_SIGNUM_API_v4_sessions_deactivateAll


Para cerrar las sesiones activas se las puede desactivar por dispositivos. Utilizando el api sessions/deactivateAll pasándole el parámetro dispositivo.


Solicitud request
AcathaDoc
Respuesta de la solicitud
AcathaDoc
Registrar sesión

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/sessions/#/store/post_amfphp_services_SIGNUM_API_v4_sessions_store


Para registrar la sesión se necesita los siguientes parámetros


KEY

TIPO

DESCRIPCION

Dispositivo String

Pc,Tablet,Pc

identificadorSesion String

Identificador único de sesion recomendado https://www.guidgenerator.com/online-guid-generator.aspx se puede obtener el código con el formato “23b6c627-6a28-4ce8-82bc-036c5e8085ae”

empresa Int

Se lo puede capturar de la respuesta del api login/autenticar del objeto emrpesas. seleccionar el codigo de la empresa que desea registrar la sesion

Ip

String

Dirección Ip desde donde se origina la solicitud, se recomienda generales/getIP

navegador String

Agente desde donde se origina la solicitud.


Solicitud Request
AcathaDoc
Respuesta de la solicitud
AcathaDoc

El key identificadorSesion registrado es el que le debe se debe pasar en todas las consultas request en el header para poder pasar la autenticación


AcathaDoc
EJEMPLO DE OBJETO PARA REGISTRAR LA SESION
{
    "infoRegistro": {
        "dispositivo": "pc",
        "identificadorSesion": "45b561e8-68a0-4973-8d2b-5f455027c9c6",
        "equipo": "pc",
        "empresa": 49,
        "mac": "",
        "ip": "192.168.001.001",
        "sistemaOperativo": "MacOs",
        "navegador": "Firefox"
    }
}

Selección de Empresa y Local


Empresa y Local

El api previamente utilizado login/autenticar retorna el objeto empresas, en el cual consta cada empresa con sus locales.

Consulta request

El api responde la información vinculada al usuario propietario del token que se ha enviado en los headers, y responde el objeto con la información del usuario, empresas y locales.


IMPORTANTE: del objeto empresas se extrae el key token. El valor de este token se lo debe enviar en todas las reques de los módulos con el nombre de header : authorization


AcathaDoc

Dentro del objeto empresa se incluyen los locales, para que el usuario seleccione el local desde donde va a generar las transacciones.


AcathaDoc

Clientes


Ingresar Clientes

Para realizar el registro de clientes se debe seguir una secuencia de consultas request, para obtener los parametros necesarios en el registro de un cliente.


Credenciales headers de las apis
1)  authorization => corresponde a la empresa en uso
2)  client_id
3)  secret_key
4)  Session-ID => emitida en la apis de control de sesiones
5)  x-csrf-token

Secuencia de api


Obtener tipos de Identificación
tipoId/listar

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/cuenta/#//tipoId/listar/get_amfphp_services_SIGNUM_API_v4_cuenta_tipoId_listar

Consulta api
AcathaDoc
Respuesta del api
AcathaDoc Obtener Tipos de Clientes
clientes/tipos

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/clientes/clientes/#/clientes/tipos/get_amfphp_services_SIGNUM_API_v4_clientes_clientes_tipos

Consulta api
AcathaDoc
Obtener Ciudades
ciudad/cargar

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/globales/#//paises/cargar/get_amfphp_services_SIGNUM_API_v4_paises_cargar

Este tiene la opción de activar o desactivar la paginación enviándole en el objeto isPaged un parámetro false/true seguidamente page indica el número de página actual y limit muestra el número de registros por página.

Filtros: se puede realizar la búsqueda por ciudad

El objeto de respuesta cambia según este activo idPaged

Consulta api

Consulta con paginación activa, con retorno de objeto preparado para la paginación


AcathaDoc

Consulta con paginación inactiva, retorna el objeto solamente con información del registro encontrado.


AcathaDoc
Registrar Cliente
clientes/ingresar

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/clientes/#//clientes/ingresar/post_amfphp_services_SIGNUM_API_v4_clientes_clientes_ingresar

Para registrar el cliente es importante enviar en el parámetro código como 0 cero.

El mismo api se lo puede para actualizar la información del cliente, con la excepción que ya no se puede enviar en el parámetro código como 0, para la edición se debe enviar el código que pertenece al cliente.

Respuesta api
AcathaDoc
Consulta api

Si el cliente se registro correctamente retorna una res puesta satisfactoria, caso contrario retorna un mensaje de error, para que se haga las correcciones del caso.


AcathaDoc
Buscar Clientes

Para realizar la búsqueda de clientes de debe utilizar el siguiente api:


clientes/listar

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/clientes/#/clientes/listar/get_amfphp_services_SIGNUM_API_v4_clientes_clientes_listar

Filtros: En este api se tiene varios key para realizar el filtro del cliente como: código, identificación,nombre, rcomercial, saldos.

Paginación: Este tiene la opción de activar o desactivar la paginación enviándole en el objeto

Consulta api

isPaged un parámetro false/true seguidamente page indica el número de página actual y limit muestra el número de registros por página.

Consumo api
AcathaDoc

Items


Ingresar Items

Para realizar el ingreso de un item se debe consultar previamente las siguientes apis:


Credenciales headers de las apis
1)  authorization => corresponde a la empresa en uso
2)  client_id
3)  secret_key
4)  Session-ID => emitida en la apis de control de sesiones
5)  x-csrf-token

Secuencia de api


Obtener Unidades
inventario/unidades/listar

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/inventario/unidades#/unidades/listar/get_amfphp_services_SIGNUM_API_v4_inventario_unidades_listar

Consulta api
AcathaDoc
Listar tipos de ICE

En el caso que el tipo de item sea tipo ICE necesita listar los diferentes tipos de ice disponibles desde el siguiente api:


generales/taxes/cBoxLoadICE

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/generales/#//taxes/cBoxLoadICE/get_amfphp_services_SIGNUM_API_v4_generales_taxes_cBoxLoadICE

Consulta api
AcathaDoc
Registrar Item
inventario/items/save

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/inventario/items/#//save/post_amfphp_services_SIGNUM_API_v4_inventario_items_save


Consulta api
AcathaDoc
Resultado api

El registro del item retorna el código del item en el objeto auto


AcathaDoc
EJEMPLO DE OBJETO REGISTRO ITEM
{
    "local": 49,
    "barras": "ServicioLoremTest",
    "nombre": "Lorem Ipsum es simplemente el texto de relleno de las imprentas y archivos de texto. Lorem Ipsum ha sido el texto de relleno estándar de las industrias desde el año 1500, cuando un impresor (N. del T. persona que se dedica a la imprenta) desconocido usó una galería de textos y los mezcló de tal manera que logró hacer un libro de textos especimen. No sólo sobrevivió 500 años, sino que tambien ingresó como texto de relleno en documentos electrónicos, quedando esencialmente igual al original. Fue popularizado en los 60s con la creación de las hojas \"Letraset\", las cuales contenian pasajes de Lorem Ipsum, y más recientemente con software de autoedición, como por ejemplo Aldus PageMaker, el cual incluye versiones de Lorem Ipsum.",
    "unidadv": 34,
    "linea": 1,
    "grupo": 0,
    "marca": 0,
    "pvp": 15.75,
    "pvd": 5.5,
    "iva": "SI",
    "tipo": 2,
    "codigo": 0,
    "tipoIce": 0,
    "codGradoAlcohol": "",
    "gradoAlcolico": 0,
    "capacidadCmCubicos": 0,
    "codigoImpuesto": "",
    "codigoClasificacion": "",
    "codigoMarca": "",
    "estado": "",
    "codigoPresentacion": "",
    "codigoUnidad": "",
    "gramosAzucar": 0,
    "ice": false
}



Buscar Item
inventario/items/searchItemsLocalSimpleSale

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/inventario/items/#//listar/get_amfphp_services_SIGNUM_API_v4_inventario_items_searchItemsLocalSimpleSale


Este tiene la opción de activar o desactivar la paginación enviándole en el objeto isPaged un parámetro false/true seguidamente page indica el número de página actual y limit muestra el número de registros por página.

Filtros: se puede realizar la búsqueda por descripcion y por el código de barras.

En este api es requerido el código local desde donde se origina búsqueda del item en el key local


Consulta api
AcathaDoc
Resultado api

La respuesta de la solicitud paginado.


AcathaDoc

Ventas


Ingresar Ventas

El api realiza los siguientes métodos que necesita el SRI para autorizar una factura en caso que la empresa tenga activado la opción de facturación electrónica. Caso contrario solo registra la venta.


  • Genera XML
  • Firma XML
  • Autoriza XML
  • Genera RIDE

Para poder consumir la API es necesario contar con credenciales validas, si aún no cuenta con sus credenciales, puede realizar la solicitud de apertura de credenciales al siguiente correo (soporte@austrosoft.com.ec) solicitando las siguientes credenciales:


Credenciales headers de las apis
1)  authorization => corresponde a la empresa en uso
2)  client_id
3)  secret_key
4)  Session-ID => emitida en la apis de control de sesiones
5)  x-csrf-token

Secuencia de api



token

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/cognito


login/autenticar

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/index/#//login/autenticar


clientes/listar

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/clientes/#/clientes/listar


formasdepago/venta

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/ventas/index.php#//formasdepago




voucherType/cboxload

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/generales/#//voucherType/cboxload




pointSale/getPointsSales

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/sidebar/#/get%20=%3E%20CargarCombos%20-%20/getPrinters


Tipo de datos

NOMBRE

TIPO

DESCRIPCION

DONDE OBTENER

identificador

string

Identificados único del comprobante

https://www.guidgenerator.com/online-guid-generator.aspx

tipodoc

string

Código del tipo de documento que se está emitiendo.

Se lo puede obtener del api

voucherType/cboxload

tipo_emision

string

Es el código que define si es facturación electrónica o no electrónica.

0 = No F. electrónica

1 = Si F. electrónica.

local

integer

Es el objeto que contiene el código del local en el que se encuentra autenticado.

Este código se lo puede obtener en la autenticación al sistema. El api es login/autenticar

pventa

string

Es la descripción del punto de venta que está utilizando el usuario.

Este código se lo puede obtener del api

pointSale/getPointsSales

fecha_emision

string

Fecha que se emite el comprobante.

 

emisor

objeto

Es el objeto json que contiene la información de la entidad que emite el comprobante.

Del api de autenticación login/autenticar

comprador

objeto

En el objeto que contiene la información del cliente.

Se lo puede obtener del api

clientes/listar

informacion_adicional

objeto

Es el objeto extra que lleva la información del cliente.

 

totales

objeto

Totalizado de la factura.

 

observaciones

string

Resumen de la compra.

 

moneda

 

Estático USD

 

formaPago

objeto

Es la forma de pago que se ha utilizado en la transacción.

Se lo puede obtener del api:

formasdepago/venta

ambiente

string

Ambiente en el que se emite la factura electrónica, producción o pruebas.

0 = Pruebas

1 = Producción.

 

items

objeto

Detalle de la factura

 

cuotas

objeto

El objeto de las cuotas en caso que la venta sea a crédito.

 

pagos

objeto

Detalle del pago

 


Objeto establecimiento

Para obtener el Establecimiento, Pto. Emisión, numero actual de comprobantes. Se debe utilizar el api:


autorizacion/extraer

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/sidebar/#/autorizacion/extraer


el parámetro “equipo” es el punto de venta que se le asigno a la máquina del cliente.


NOMBRE

TIPO

DESCRIPCION

DONDE OBTENER

punto_emision

string

Punto de emisión otorgado por el SRI desde donde se emite el comprobante

autorizacion/extraer

codigo

string

Código del Punto de emisión otorgado por el SRI desde donde se emite el comprobante

autorizacion/extraer


Ejemplo del objeto json que se envía al api ventas/ingresar.


{
    "identificador": "9584d6de-792c-41fb-bce9-d24a04c83093",
    "tipodoc": "01",
    "tipo_emision": "1",
    "local": {
        "codigo": 2
    },
    "pventa": "CHRISTIAN@AUSTROSOFT.COM.EC",
    "fecha_emision": "19/02/2024",
    "emisor": {
        "ruc": "0103573283001",
        "razon_social": "MICHAEL ASTUDILLO",
        "nombre_comercial": "EMPRESA CAPACITACIONES PRUEBAS",
        "contribuyente_especial": "",
        "direccion": "FRANCISCO MOSCOSO 6-25 Y AV. 10 DE AGOSTO UPDATE 2.0 FRONT",
        "obligado_contabilidad": true,
        "establecimiento": {
            "punto_emision": "001",
            "codigo": "2",
            "direccion": "FRANCISCO MOSCOSO 6-25 Y AV. 10 DE AGOSTO"
        }
    },
    "comprador": {
        "tipo_identificacion": "04",
        "identificacion": "0105118509001",
        "nombres": "TIGRE CONDO CHRISTIAN ANDRES",
        "razon_social": "TIGRE CONDO CHRISTIAN ANDRES",
        "direccion": "TRES DE NOVIEMBRE. S/N Y CESAR CUEVA. Editado test",
        "email": "andrescondo17@gmail.com;info@info.com",
        "telefono": "0992702599",
        "ciudad": "CUENCA"
    },
    "informacion_adicional": {
        "Cliente": "TIGRE CONDO CHRISTIAN ANDRES",
        "Enviado_a": "andrescondo17@gmail.com;info@info.com",
        "Direccion": "TRES DE NOVIEMBRE. S/N Y CESAR CUEVA. Editado test",
        "Telefono": "0992702599"
    },
    "totales": {
        "total_sin_impuestos": 40.18,
        "importe_total": 45,
        "propina": 0,
        "descuento": 0,
        "descuento_adicional": 0,
        "impuestos": [
            {
                "codigo": 2,
                "codigo_porcentaje": "2",
                "descuento_adicional": 0,
                "base_imponible": 40.18,
                "valor": 4.82
            },
            {
                "codigo": 2,
                "codigo_porcentaje": "0",
                "descuento_adicional": 0,
                "base_imponible": 0,
                "valor": 0
            }
        ]
    },
    "observaciones": "demo observacion",
    "moneda": "USD",
    "formaPago": {
        "value": 8,
        "label": "CREDITO"
    },
    "ambiente": "1",
    "items": [
        {
            "codigo_auxiliar": "9291",
            "codigo_principal": "963963",
            "precio_unitario": 13.3929,
            "cantidad": 1,
            "precio_total_sin_impuestos": 13.3929,
            "descripcion": "tets item service solution",
            "descuento": 0,
            "detalles_adicionales": {},
            "impuestos": [
                {
                    "codigo": 3,
                    "tarifa": "12",
                    "codigo_porcentaje": 2,
                    "base_imponible": 13.3929,
                    "valor": 1.6071
                }
            ]
        },
        {
            "codigo_auxiliar": "9291",
            "codigo_principal": "963963",
            "precio_unitario": 13.3929,
            "cantidad": 1,
            "precio_total_sin_impuestos": 13.3929,
            "descripcion": "tets item service solution",
            "descuento": 0,
            "detalles_adicionales": {},
            "impuestos": [
                {
                    "codigo": 3,
                    "tarifa": "12",
                    "codigo_porcentaje": 2,
                    "base_imponible": 13.3929,
                    "valor": 1.6071
                }
            ]
        },
        {
            "codigo_auxiliar": "1842",
            "codigo_principal": "0N0A00002",
            "precio_unitario": 13.3929,
            "cantidad": 1,
            "precio_total_sin_impuestos": 13.3929,
            "descripcion": "ACEITES",
            "descuento": 0,
            "detalles_adicionales": {},
            "impuestos": [
                {
                    "codigo": 3,
                    "tarifa": "12",
                    "codigo_porcentaje": 2,
                    "base_imponible": 13.3929,
                    "valor": 1.6071
                }
            ]
        }
    ],
    "cuotas": [
        {
            "cuota": 45,
            "fechaVencimiento": "19/03/2024",
            "saldo": 45,
            "interes": 0,
            "letra": "LETRA 1\\1",
            "saldoCapital": 45
        }
    ],
    "pagos": [
        {
            "total": 45,
            "medio": "CREDITO",
            "id_medio": "8"
        }
    ],
    "tiposPagos": []
}

Resultado api
{
    "error": false,
    "codigo": 0,
    "message": "Registro satisfactorio",
    "auto": {
        objeto venta
    }
}

Para listar los comprobantes se los puede revisar en el api:


ventas/listar

Documentación swagger => https://dev.acatha.com/amfphp/services/SIGNUM/API/v4/documentacion/ventas/#/listar%20=%3E%20Listar%20-%20/listar


Para realizar el filtro de facturas se tiene diferentes key por buscar, clave_acceso, desde, hasta, numero, nombre, identificación, autorización, pventa, código

Consulta api
AcathaDoc
Resultado api
AcathaDoc