GRDSOFT Logo
Developers v1.0
GRDSOFT Developer Platform

Construye integraciones potentes con GRDSOFT

API RESTful de nivel empresarial para integrar facturación fiscal NCF, ventas, transferencias de inventario, clientes, turnos de caja y control multitenant.

Explorar API Docs Ver Endpoints
REST API JSON JWT + License Key Multitenant v1 / v2
cURL Request Example
200 OK 
curl --request POST \
  --url 'https://your-api-host/grd-api/v1/venta/crear' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --header 'grd-license: YOUR_LICENSE_KEY' \
  --data '{ "empresa": 1, "cliente": 105, "total": 1250.00 }'
Platform Metrics & Specs
API Status
Online
Protocol & Data REST / JSON
Authentication JWT + License
Data Layer SQL / Sequelize

Comienza en minutos

Pasos esenciales para autenticar tu cliente e integrar servicios de GRDSOFT.

PASO 01

Obtén credenciales

Solicita la llave de licencia corporativa grd-license correspondiente a tu empresa tenant.

PASO 02

Autentica tu app

Envía credenciales de usuario a POST /grd-api/v1/usuario/auth0 para recibir tu Bearer JWT Token.

PASO 03

Consume la API

Realiza solicitudes HTTP REST adjuntando los encabezados Authorization y grd-license.

Módulos de la API REST

Explora los servicios y endpoints disponibles en el ecosistema GRDSOFT.

Ver todos en Swagger
POST

Transferencias

Traspasos de mercancía entre sucursales y almacenes, recepción de lotes e impresión de reportes (`TranfReportObject`).

/grd-api/v1/transferenciainv/crear
POST

Ventas & Pedidos

Facturación NCF de contado/crédito, cancelación de documentos, división/unión e impresión de pre-facturas (`ImpresionPedido`).

/grd-api/v1/venta/crear
POST

Turnos & Cajas

Aperturas de fondo de caja, desglose por denominación de billetes/monedas, cierres y consulta de transacciones por cajero.

/grd-api/v1/turno/apertura
GET

Productos & Stock

Catálogo general de artículos, precios por unidad de medida, grupos, categorías, costos e imágenes de producto.

/grd-api/v1/producto/:producto
POST

Clientes & RNC

Directorio comercial de clientes, consulta por RNC/Cédula, límite de crédito y condiciones de pago asociadas.

/grd-api/v1/cliente/consulta
POST

Seguridad & JWT

Autenticación `POST /auth0`, encabezado multitenant `grd-license`, control de sesiones activas y privilegios por usuario.

/grd-api/v1/usuario/auth0
POST /grd-api/v1/transferenciainv/crear
Content-Type: application/json 
{
  "empresa": 1,
  "turno": 0,
  "sucursalOrigen": 1,
  "sucursalDestino": 2,
  "almacenOrigen": 1,
  "almacenDestino": 2,
  "tipo": 1,
  "notas": "Transferencia de mercancía entre almacenes",
  "total": 2500.00,
  "usuario": 1,
  "usuarioNombre": "ADMIN",
  "detalle": [
    {
      "producto": 101,
      "descripcion": "Arroz Selecto 10Lbs",
      "cantidad": 10,
      "costo": 250.00,
      "total": 2500.00
    }
  ]
}