API REST · OAuth 2.0

Documentación CDEpos API

Integrá tu app móvil, sistema contable, plataforma de e-commerce, terminales POS o cualquier dispositivo con tu negocio. 500 endpoints REST disponibles.

Endpoint base: https://app.micdepos.com/connector/api
→

Empezá acá

Pasos para conectar tu primer dispositivo
1 — Endpoint base 2 — Autenticación 3 — Flujo OAuth 4 — Lista de endpoints 5 — Ejemplos curl 6 — Códigos de error
⚡

¿Ya tenés tu propio sistema y solo necesitás factura electrónica?

SIFEN como servicio: tu ERP / facturador manda la venta y CDEpos numera, firma, envía al SET y devuelve CDC, QR, KuDE y XML.
Una sola llamada: POST /connector/api/sell con sifen_emit: true, el cliente por RUC y los ítems por SKU (se crean solos la primera vez). Incluye idempotencia, consulta de estado, KuDE PDF, anulación y notas de crédito.
Ver guía de integración →
🔗

Endpoint base

Todas las URLs empiezan con este prefijo
https://app.micdepos.com/connector/api

HTTPS obligatorio. Soporta CORS con cualquier origen.

🔑

Autenticación

OAuth 2.0 · Password Grant

Cada request a la API debe incluir el header:

Authorization: Bearer <access_token>

El admin del negocio te debe entregar tus 4 credenciales: Client ID, Client Secret, API username y API password.

⚡

Flujo de autenticación

3 pasos para empezar a llamar a la API

Solicitar las credenciales al admin del negocio

El dueño / administrador genera 4 credenciales únicas para tu integración desde el panel: Client ID, Client Secret, API username, API password. El secret y password se muestran una sola vez al crear el cliente.

Pedir un access token (POST OAuth)

Tu app envía las 4 credenciales al endpoint OAuth y recibe un access_token válido (típicamente 1 hora).

POST https://app.micdepos.com/oauth/token
Content-Type: application/json

{
  "grant_type": "password",
  "client_id": "tu_client_id",
  "client_secret": "tu_client_secret",
  "username": "tu_api_username",
  "password": "tu_api_password",
  "scope": "*"
}

Llamar a los endpoints de la API

Usá el token recibido en cada request. Cuando expira (HTTP 401) pedí uno nuevo.

GET https://app.micdepos.com/connector/api/contactapi
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOi...
📋

Endpoints disponibles

78 grupos · 500 endpoints REST
account-types
1 endpoint ▾
GET
/connector/api/account-types
accounts
14 endpoints ▾
GET
/connector/api/accounts
POST
/connector/api/accounts
GET
/connector/api/accounts/balance-sheet
GET
/connector/api/accounts/cash-flow
POST
/connector/api/accounts/fund-transfer
GET
/connector/api/accounts/payment-account-report
GET
/connector/api/accounts/trial-balance
GET
/connector/api/accounts/{id}
PUT
/connector/api/accounts/{id}
POST
/connector/api/accounts/{id}/activate
GET
/connector/api/accounts/{id}/balance
POST
/connector/api/accounts/{id}/close
POST
/connector/api/accounts/{id}/deposit
GET
/connector/api/accounts/{id}/transactions
active-subscription
1 endpoint ▾
GET
/connector/api/active-subscription
brand
5 endpoints ▾
GET
/connector/api/brand
POST
/connector/api/brand
GET
/connector/api/brand/{brand}
PUT PATCH
/connector/api/brand/{brand}
DELETE
/connector/api/brand/{brand}
business-details
1 endpoint ▾
GET
/connector/api/business-details
business-location
2 endpoints ▾
GET
/connector/api/business-location
GET
/connector/api/business-location/{business_location}
cash-register
7 endpoints ▾
GET
/connector/api/cash-register
POST
/connector/api/cash-register
GET
/connector/api/cash-register/{cash_register}
PUT PATCH
/connector/api/cash-register/{cash_register}
GET
/connector/api/cash-register/{id}/end-of-day
GET
/connector/api/cash-register/{id}/expenses
GET
/connector/api/cash-register/{id}/summary
catalogues
6 endpoints ▾
GET
/connector/api/catalogues
POST
/connector/api/catalogues
GET
/connector/api/catalogues/opciones
GET
/connector/api/catalogues/{id}
PUT
/connector/api/catalogues/{id}
DELETE
/connector/api/catalogues/{id}
clock-in
1 endpoint ▾
POST
/connector/api/clock-in
clock-out
1 endpoint ▾
POST
/connector/api/clock-out
contactapi
6 endpoints ▾
GET
/connector/api/contactapi
POST
/connector/api/contactapi
GET
/connector/api/contactapi/{contactapi}
PUT PATCH
/connector/api/contactapi/{contactapi}
DELETE
/connector/api/contactapi/{contactapi}
GET
/connector/api/contactapi/{id}/saldo-a-favor
contactapi-ficha-link
1 endpoint ▾
POST
/connector/api/contactapi-ficha-link
contactapi-lookup
1 endpoint ▾
GET
/connector/api/contactapi-lookup
contactapi-payment
1 endpoint ▾
POST
/connector/api/contactapi-payment
crm
7 endpoints ▾
POST
/connector/api/crm/call-logs
GET
/connector/api/crm/follow-up-resources
GET
/connector/api/crm/follow-ups
POST
/connector/api/crm/follow-ups
GET
/connector/api/crm/follow-ups/{follow_up}
PUT PATCH
/connector/api/crm/follow-ups/{follow_up}
GET
/connector/api/crm/leads
cuenta
7 endpoints ▾
GET
/connector/api/cuenta/correo
POST
/connector/api/cuenta/correo/codigo
POST
/connector/api/cuenta/correo/verificar
GET
/connector/api/cuenta/eliminacion
POST
/connector/api/cuenta/eliminacion
POST
/connector/api/cuenta/recuperar
POST
/connector/api/cuenta/recuperar/codigo
currencies
1 endpoint ▾
GET
/connector/api/currencies
customer-group
1 endpoint ▾
GET
/connector/api/customer-group
delivery
2 endpoints ▾
GET
/connector/api/delivery/my-orders
POST
/connector/api/delivery/{transaction_id}/status
deudas
2 endpoints ▾
GET
/connector/api/deudas
POST
/connector/api/deudas/pagar
device-token
2 endpoints ▾
POST
/connector/api/device-token
DELETE
/connector/api/device-token
exchange-rates
3 endpoints ▾
GET
/connector/api/exchange-rates
POST
/connector/api/exchange-rates
GET
/connector/api/exchange-rates/anteriores
expense
4 endpoints ▾
GET
/connector/api/expense
POST
/connector/api/expense
GET
/connector/api/expense/{expense}
PUT PATCH
/connector/api/expense/{expense}
expense-categories
1 endpoint ▾
GET
/connector/api/expense-categories
expense-refund
1 endpoint ▾
GET
/connector/api/expense-refund
factura-electronica
8 endpoints ▾
GET
/connector/api/factura-electronica/{location_id}
PUT
/connector/api/factura-electronica/{location_id}/ambiente
POST
/connector/api/factura-electronica/{location_id}/certificado
PUT
/connector/api/factura-electronica/{location_id}/csc
POST
/connector/api/factura-electronica/{location_id}/datos-de-prueba
PUT
/connector/api/factura-electronica/{location_id}/emisor
POST
/connector/api/factura-electronica/{location_id}/probar-conexion
PUT
/connector/api/factura-electronica/{location_id}/timbrado
field-force
3 endpoints ▾
GET
/connector/api/field-force
POST
/connector/api/field-force/create
POST
/connector/api/field-force/update-visit-status/{id}
forget-password
1 endpoint ▾
POST
/connector/api/forget-password
general
1 endpoint ▾
GET
/connector/api
get-attendance
1 endpoint ▾
GET
/connector/api/get-attendance/{user_id}
get-location
1 endpoint ▾
GET
/connector/api/get-location
health
1 endpoint ▾
GET
/connector/api/health
holidays
1 endpoint ▾
GET
/connector/api/holidays
impresion
4 endpoints ▾
POST
/connector/api/impresion/factura-a4
POST
/connector/api/impresion/pc
GET
/connector/api/impresion/pc/{id}
GET
/connector/api/impresion/pcs
invoice-layouts
2 endpoints ▾
GET
/connector/api/invoice-layouts
PUT
/connector/api/invoice-layouts/{id}/doc-role
invoice-schemes
1 endpoint ▾
GET
/connector/api/invoice-schemes
job-sheets
13 endpoints ▾
GET
/connector/api/job-sheets
POST
/connector/api/job-sheets
GET
/connector/api/job-sheets/buscar-repuestos
GET
/connector/api/job-sheets/catalogos
GET
/connector/api/job-sheets/historial
GET
/connector/api/job-sheets/tablero
GET
/connector/api/job-sheets/{id}
PUT
/connector/api/job-sheets/{id}
POST
/connector/api/job-sheets/{id}/estado
POST
/connector/api/job-sheets/{id}/fotos
DELETE
/connector/api/job-sheets/{id}/fotos/{media_id}
POST
/connector/api/job-sheets/{id}/presupuesto
PUT
/connector/api/job-sheets/{id}/repuestos
list-sell-return
1 endpoint ▾
GET
/connector/api/list-sell-return
movimientos
2 endpoints ▾
GET
/connector/api/movimientos
GET
/connector/api/movimientos/filtros
new_contactapi
1 endpoint ▾
GET
/connector/api/new_contactapi
new_product
1 endpoint ▾
GET
/connector/api/new_product
new_sell
1 endpoint ▾
GET
/connector/api/new_sell
notifications
1 endpoint ▾
GET
/connector/api/notifications
packages
1 endpoint ▾
GET
/connector/api/packages
payment-accounts
1 endpoint ▾
GET
/connector/api/payment-accounts
payment-methods
1 endpoint ▾
GET
/connector/api/payment-methods
planes
1 endpoint ▾
GET
/connector/api/planes
print-agent
1 endpoint ▾
POST
/connector/api/print-agent/pair
print-jobs
4 endpoints ▾
GET
/connector/api/print-jobs
GET
/connector/api/print-jobs/documento/{id}/pdf
GET
/connector/api/print-jobs/invoice/{transaction_id}/pdf
POST
/connector/api/print-jobs/{id}/printed
product
5 endpoints ▾
GET
/connector/api/product
POST
/connector/api/product
GET
/connector/api/product/{product}
PUT PATCH
/connector/api/product/{product}
DELETE
/connector/api/product/{product}
product-modifiers
1 endpoint ▾
GET
/connector/api/product-modifiers/{product_id}
product-stock-report
1 endpoint ▾
GET
/connector/api/product-stock-report
profit-loss-report
1 endpoint ▾
GET
/connector/api/profit-loss-report
purchase
4 endpoints ▾
GET
/connector/api/purchase
POST
/connector/api/purchase
POST
/connector/api/purchase/preview-de
GET
/connector/api/purchase/{purchase}
registro
2 endpoints ▾
POST
/connector/api/registro
POST
/connector/api/registro/codigo
restaurant
15 endpoints ▾
POST
/connector/api/restaurant/comandas/{id}/priority
POST
/connector/api/restaurant/comandas/{id}/reimprimir
GET
/connector/api/restaurant/comandas/{id}/ticket
GET
/connector/api/restaurant/kds
POST
/connector/api/restaurant/kds/comanda/{id}/cocida
POST
/connector/api/restaurant/kds/comanda/{id}/entregada
GET
/connector/api/restaurant/kitchen-stations
GET
/connector/api/restaurant/ordenes
POST
/connector/api/restaurant/ordenes/{id}/marcar-entregada
POST
/connector/api/restaurant/ordenes/{id}/marcar-lista
POST
/connector/api/restaurant/sell/{id}/lanzar-kot
GET
/connector/api/restaurant/status
GET
/connector/api/restaurant/tables
GET
/connector/api/restaurant/tables/{table_id}/comandas
GET
/connector/api/restaurant/tables/{table_id}/transactions
sell
15 endpoints ▾
GET
/connector/api/sell
POST
/connector/api/sell
GET
/connector/api/sell/{id}/pdf
GET
/connector/api/sell/{id}/print-data
GET
/connector/api/sell/{id}/print-receipt
POST
/connector/api/sell/{id}/sifen/cancel
POST
/connector/api/sell/{id}/sifen/email
POST
/connector/api/sell/{id}/sifen/emit
POST
/connector/api/sell/{id}/sifen/retry
GET
/connector/api/sell/{id}/sifen/status
GET
/connector/api/sell/{id}/sifen/xml
DELETE
/connector/api/sell/{sale_id}/lines/{line_id}
GET
/connector/api/sell/{sell}
PUT PATCH
/connector/api/sell/{sell}
DELETE
/connector/api/sell/{sell}
sell-return
3 endpoints ▾
POST
/connector/api/sell-return
GET
/connector/api/sell-return/opciones
GET
/connector/api/sell-return/{id}/print-data
selling-price-group
4 endpoints ▾
GET
/connector/api/selling-price-group
POST
/connector/api/selling-price-group
PUT
/connector/api/selling-price-group/{id}
DELETE
/connector/api/selling-price-group/{id}
sifen
7 endpoints ▾
GET
/connector/api/sifen/webhooks
POST
/connector/api/sifen/webhooks
PUT
/connector/api/sifen/webhooks/{id}
DELETE
/connector/api/sifen/webhooks/{id}
GET
/connector/api/sifen/webhooks/{id}/deliveries
POST
/connector/api/sifen/webhooks/{id}/deliveries/{deliveryId}/retry
POST
/connector/api/sifen/webhooks/{id}/test
sifen-catalogs
16 endpoints ▾
GET
/connector/api/sifen-catalogs
GET
/connector/api/sifen-catalogs/actividades-economicas
GET
/connector/api/sifen-catalogs/ciudades
GET
/connector/api/sifen-catalogs/departamentos
GET
/connector/api/sifen-catalogs/distritos
GET
/connector/api/sifen-catalogs/es-contribuyente
GET
/connector/api/sifen-catalogs/monedas
GET
/connector/api/sifen-catalogs/motivos-nc
GET
/connector/api/sifen-catalogs/motivos-nd
GET
/connector/api/sifen-catalogs/paises
GET
/connector/api/sifen-catalogs/tipos-contribuyente
GET
/connector/api/sifen-catalogs/tipos-documento-identidad
GET
/connector/api/sifen-catalogs/tipos-operacion
GET
/connector/api/sifen-catalogs/tipos-regimen
GET
/connector/api/sifen-catalogs/tipos-transaccion
GET
/connector/api/sifen-catalogs/unidades-medida
stock-adjustment
6 endpoints ▾
POST
/connector/api/stock-adjustment
GET
/connector/api/stock-adjustment
GET
/connector/api/stock-adjustment/opciones
GET
/connector/api/stock-adjustment/{id}
POST
/connector/api/stock-adjustment/{id}/cancel
POST
/connector/api/stock-adjustment/{id}/validate
suscripcion
1 endpoint ▾
GET
/connector/api/suscripcion
table
5 endpoints ▾
GET
/connector/api/table
POST
/connector/api/table
GET
/connector/api/table/{table}
PUT PATCH
/connector/api/table/{table}
DELETE
/connector/api/table/{table}
table-group
5 endpoints ▾
GET
/connector/api/table-group
POST
/connector/api/table-group
GET
/connector/api/table-group/{table_group}
PUT PATCH
/connector/api/table-group/{table_group}
DELETE
/connector/api/table-group/{table_group}
tax
2 endpoints ▾
GET
/connector/api/tax
GET
/connector/api/tax/{tax}
taxonomy
5 endpoints ▾
GET
/connector/api/taxonomy
POST
/connector/api/taxonomy
GET
/connector/api/taxonomy/{taxonomy}
PUT PATCH
/connector/api/taxonomy/{taxonomy}
DELETE
/connector/api/taxonomy/{taxonomy}
timbrado-status
1 endpoint ▾
GET
/connector/api/timbrado-status
types-of-service
2 endpoints ▾
GET
/connector/api/types-of-service
GET
/connector/api/types-of-service/{types_of_service}
unit
5 endpoints ▾
GET
/connector/api/unit
POST
/connector/api/unit
GET
/connector/api/unit/{unit}
PUT PATCH
/connector/api/unit/{unit}
DELETE
/connector/api/unit/{unit}
update-password
1 endpoint ▾
POST
/connector/api/update-password
update-shipping-status
1 endpoint ▾
POST
/connector/api/update-shipping-status
user
3 endpoints ▾
GET
/connector/api/user
GET
/connector/api/user/loggedin
GET
/connector/api/user/{user}
user-registration
1 endpoint ▾
POST
/connector/api/user-registration
v1
249 endpoints ▾
GET
/connector/api/v1/account-types
GET
/connector/api/v1/accounts
POST
/connector/api/v1/accounts
GET
/connector/api/v1/accounts/balance-sheet
GET
/connector/api/v1/accounts/cash-flow
POST
/connector/api/v1/accounts/fund-transfer
GET
/connector/api/v1/accounts/payment-account-report
GET
/connector/api/v1/accounts/trial-balance
GET
/connector/api/v1/accounts/{id}
PUT
/connector/api/v1/accounts/{id}
POST
/connector/api/v1/accounts/{id}/activate
GET
/connector/api/v1/accounts/{id}/balance
POST
/connector/api/v1/accounts/{id}/close
POST
/connector/api/v1/accounts/{id}/deposit
GET
/connector/api/v1/accounts/{id}/transactions
GET
/connector/api/v1/active-subscription
GET
/connector/api/v1/brand
POST
/connector/api/v1/brand
GET
/connector/api/v1/brand/{brand}
PUT PATCH
/connector/api/v1/brand/{brand}
DELETE
/connector/api/v1/brand/{brand}
GET
/connector/api/v1/business-details
GET
/connector/api/v1/business-location
GET
/connector/api/v1/business-location/{business_location}
GET
/connector/api/v1/cash-register
POST
/connector/api/v1/cash-register
GET
/connector/api/v1/cash-register/{cash_register}
PUT PATCH
/connector/api/v1/cash-register/{cash_register}
GET
/connector/api/v1/cash-register/{id}/end-of-day
GET
/connector/api/v1/cash-register/{id}/expenses
GET
/connector/api/v1/cash-register/{id}/summary
GET
/connector/api/v1/catalogues
POST
/connector/api/v1/catalogues
GET
/connector/api/v1/catalogues/opciones
GET
/connector/api/v1/catalogues/{id}
PUT
/connector/api/v1/catalogues/{id}
DELETE
/connector/api/v1/catalogues/{id}
POST
/connector/api/v1/clock-in
POST
/connector/api/v1/clock-out
GET
/connector/api/v1/contactapi
POST
/connector/api/v1/contactapi
POST
/connector/api/v1/contactapi-ficha-link
GET
/connector/api/v1/contactapi-lookup
POST
/connector/api/v1/contactapi-payment
GET
/connector/api/v1/contactapi/{contactapi}
PUT PATCH
/connector/api/v1/contactapi/{contactapi}
DELETE
/connector/api/v1/contactapi/{contactapi}
GET
/connector/api/v1/contactapi/{id}/saldo-a-favor
POST
/connector/api/v1/crm/call-logs
GET
/connector/api/v1/crm/follow-up-resources
GET
/connector/api/v1/crm/follow-ups
POST
/connector/api/v1/crm/follow-ups
GET
/connector/api/v1/crm/follow-ups/{follow_up}
PUT PATCH
/connector/api/v1/crm/follow-ups/{follow_up}
GET
/connector/api/v1/crm/leads
GET
/connector/api/v1/cuenta/correo
POST
/connector/api/v1/cuenta/correo/codigo
POST
/connector/api/v1/cuenta/correo/verificar
GET
/connector/api/v1/cuenta/eliminacion
POST
/connector/api/v1/cuenta/eliminacion
POST
/connector/api/v1/cuenta/recuperar
POST
/connector/api/v1/cuenta/recuperar/codigo
GET
/connector/api/v1/currencies
GET
/connector/api/v1/customer-group
GET
/connector/api/v1/delivery/my-orders
POST
/connector/api/v1/delivery/{transaction_id}/status
GET
/connector/api/v1/deudas
POST
/connector/api/v1/deudas/pagar
POST
/connector/api/v1/device-token
DELETE
/connector/api/v1/device-token
GET
/connector/api/v1/exchange-rates
POST
/connector/api/v1/exchange-rates
GET
/connector/api/v1/exchange-rates/anteriores
GET
/connector/api/v1/expense
POST
/connector/api/v1/expense
GET
/connector/api/v1/expense-categories
GET
/connector/api/v1/expense-refund
GET
/connector/api/v1/expense/{expense}
PUT PATCH
/connector/api/v1/expense/{expense}
GET
/connector/api/v1/factura-electronica/{location_id}
PUT
/connector/api/v1/factura-electronica/{location_id}/ambiente
POST
/connector/api/v1/factura-electronica/{location_id}/certificado
PUT
/connector/api/v1/factura-electronica/{location_id}/csc
POST
/connector/api/v1/factura-electronica/{location_id}/datos-de-prueba
PUT
/connector/api/v1/factura-electronica/{location_id}/emisor
POST
/connector/api/v1/factura-electronica/{location_id}/probar-conexion
PUT
/connector/api/v1/factura-electronica/{location_id}/timbrado
GET
/connector/api/v1/field-force
POST
/connector/api/v1/field-force/create
POST
/connector/api/v1/field-force/update-visit-status/{id}
POST
/connector/api/v1/forget-password
GET
/connector/api/v1/get-attendance/{user_id}
GET
/connector/api/v1/get-location
GET
/connector/api/v1/health
GET
/connector/api/v1/holidays
POST
/connector/api/v1/impresion/factura-a4
POST
/connector/api/v1/impresion/pc
GET
/connector/api/v1/impresion/pc/{id}
GET
/connector/api/v1/impresion/pcs
GET
/connector/api/v1/invoice-layouts
PUT
/connector/api/v1/invoice-layouts/{id}/doc-role
GET
/connector/api/v1/invoice-schemes
GET
/connector/api/v1/job-sheets
POST
/connector/api/v1/job-sheets
GET
/connector/api/v1/job-sheets/buscar-repuestos
GET
/connector/api/v1/job-sheets/catalogos
GET
/connector/api/v1/job-sheets/historial
GET
/connector/api/v1/job-sheets/tablero
GET
/connector/api/v1/job-sheets/{id}
PUT
/connector/api/v1/job-sheets/{id}
POST
/connector/api/v1/job-sheets/{id}/estado
POST
/connector/api/v1/job-sheets/{id}/fotos
DELETE
/connector/api/v1/job-sheets/{id}/fotos/{media_id}
POST
/connector/api/v1/job-sheets/{id}/presupuesto
PUT
/connector/api/v1/job-sheets/{id}/repuestos
GET
/connector/api/v1/list-sell-return
GET
/connector/api/v1/movimientos
GET
/connector/api/v1/movimientos/filtros
GET
/connector/api/v1/new_contactapi
GET
/connector/api/v1/new_product
GET
/connector/api/v1/new_sell
GET
/connector/api/v1/notifications
GET
/connector/api/v1/packages
GET
/connector/api/v1/payment-accounts
GET
/connector/api/v1/payment-methods
GET
/connector/api/v1/planes
GET
/connector/api/v1/print-jobs
GET
/connector/api/v1/print-jobs/documento/{id}/pdf
GET
/connector/api/v1/print-jobs/invoice/{transaction_id}/pdf
POST
/connector/api/v1/print-jobs/{id}/printed
GET
/connector/api/v1/product
POST
/connector/api/v1/product
GET
/connector/api/v1/product-modifiers/{product_id}
GET
/connector/api/v1/product-stock-report
GET
/connector/api/v1/product/{product}
PUT PATCH
/connector/api/v1/product/{product}
DELETE
/connector/api/v1/product/{product}
GET
/connector/api/v1/profit-loss-report
GET
/connector/api/v1/purchase
POST
/connector/api/v1/purchase
POST
/connector/api/v1/purchase/preview-de
GET
/connector/api/v1/purchase/{purchase}
POST
/connector/api/v1/registro
POST
/connector/api/v1/registro/codigo
POST
/connector/api/v1/restaurant/comandas/{id}/priority
POST
/connector/api/v1/restaurant/comandas/{id}/reimprimir
GET
/connector/api/v1/restaurant/comandas/{id}/ticket
GET
/connector/api/v1/restaurant/kds
POST
/connector/api/v1/restaurant/kds/comanda/{id}/cocida
POST
/connector/api/v1/restaurant/kds/comanda/{id}/entregada
GET
/connector/api/v1/restaurant/kitchen-stations
GET
/connector/api/v1/restaurant/ordenes
POST
/connector/api/v1/restaurant/ordenes/{id}/marcar-entregada
POST
/connector/api/v1/restaurant/ordenes/{id}/marcar-lista
POST
/connector/api/v1/restaurant/sell/{id}/lanzar-kot
GET
/connector/api/v1/restaurant/status
GET
/connector/api/v1/restaurant/tables
GET
/connector/api/v1/restaurant/tables/{table_id}/comandas
GET
/connector/api/v1/restaurant/tables/{table_id}/transactions
GET
/connector/api/v1/sell
POST
/connector/api/v1/sell
POST
/connector/api/v1/sell-return
GET
/connector/api/v1/sell-return/opciones
GET
/connector/api/v1/sell-return/{id}/print-data
GET
/connector/api/v1/sell/{id}/pdf
GET
/connector/api/v1/sell/{id}/print-data
GET
/connector/api/v1/sell/{id}/print-receipt
POST
/connector/api/v1/sell/{id}/sifen/cancel
POST
/connector/api/v1/sell/{id}/sifen/email
POST
/connector/api/v1/sell/{id}/sifen/emit
POST
/connector/api/v1/sell/{id}/sifen/retry
GET
/connector/api/v1/sell/{id}/sifen/status
GET
/connector/api/v1/sell/{id}/sifen/xml
DELETE
/connector/api/v1/sell/{sale_id}/lines/{line_id}
GET
/connector/api/v1/sell/{sell}
PUT PATCH
/connector/api/v1/sell/{sell}
DELETE
/connector/api/v1/sell/{sell}
GET
/connector/api/v1/selling-price-group
POST
/connector/api/v1/selling-price-group
PUT
/connector/api/v1/selling-price-group/{id}
DELETE
/connector/api/v1/selling-price-group/{id}
GET
/connector/api/v1/sifen-catalogs
GET
/connector/api/v1/sifen-catalogs/actividades-economicas
GET
/connector/api/v1/sifen-catalogs/ciudades
GET
/connector/api/v1/sifen-catalogs/departamentos
GET
/connector/api/v1/sifen-catalogs/distritos
GET
/connector/api/v1/sifen-catalogs/es-contribuyente
GET
/connector/api/v1/sifen-catalogs/monedas
GET
/connector/api/v1/sifen-catalogs/motivos-nc
GET
/connector/api/v1/sifen-catalogs/motivos-nd
GET
/connector/api/v1/sifen-catalogs/paises
GET
/connector/api/v1/sifen-catalogs/tipos-contribuyente
GET
/connector/api/v1/sifen-catalogs/tipos-documento-identidad
GET
/connector/api/v1/sifen-catalogs/tipos-operacion
GET
/connector/api/v1/sifen-catalogs/tipos-regimen
GET
/connector/api/v1/sifen-catalogs/tipos-transaccion
GET
/connector/api/v1/sifen-catalogs/unidades-medida
GET
/connector/api/v1/sifen/webhooks
POST
/connector/api/v1/sifen/webhooks
PUT
/connector/api/v1/sifen/webhooks/{id}
DELETE
/connector/api/v1/sifen/webhooks/{id}
GET
/connector/api/v1/sifen/webhooks/{id}/deliveries
POST
/connector/api/v1/sifen/webhooks/{id}/deliveries/{deliveryId}/retry
POST
/connector/api/v1/sifen/webhooks/{id}/test
POST
/connector/api/v1/stock-adjustment
GET
/connector/api/v1/stock-adjustment
GET
/connector/api/v1/stock-adjustment/opciones
GET
/connector/api/v1/stock-adjustment/{id}
POST
/connector/api/v1/stock-adjustment/{id}/cancel
POST
/connector/api/v1/stock-adjustment/{id}/validate
GET
/connector/api/v1/suscripcion
GET
/connector/api/v1/table
POST
/connector/api/v1/table
GET
/connector/api/v1/table-group
POST
/connector/api/v1/table-group
GET
/connector/api/v1/table-group/{table_group}
PUT PATCH
/connector/api/v1/table-group/{table_group}
DELETE
/connector/api/v1/table-group/{table_group}
GET
/connector/api/v1/table/{table}
PUT PATCH
/connector/api/v1/table/{table}
DELETE
/connector/api/v1/table/{table}
GET
/connector/api/v1/tax
GET
/connector/api/v1/tax/{tax}
GET
/connector/api/v1/taxonomy
POST
/connector/api/v1/taxonomy
GET
/connector/api/v1/taxonomy/{taxonomy}
PUT PATCH
/connector/api/v1/taxonomy/{taxonomy}
DELETE
/connector/api/v1/taxonomy/{taxonomy}
GET
/connector/api/v1/timbrado-status
GET
/connector/api/v1/types-of-service
GET
/connector/api/v1/types-of-service/{types_of_service}
GET
/connector/api/v1/unit
POST
/connector/api/v1/unit
GET
/connector/api/v1/unit/{unit}
PUT PATCH
/connector/api/v1/unit/{unit}
DELETE
/connector/api/v1/unit/{unit}
POST
/connector/api/v1/update-password
POST
/connector/api/v1/update-shipping-status
GET
/connector/api/v1/user
POST
/connector/api/v1/user-registration
GET
/connector/api/v1/user/loggedin
GET
/connector/api/v1/user/{user}
GET
/connector/api/v1/variation-template
POST
/connector/api/v1/variation-template
GET
/connector/api/v1/variation/{id?}
GET
/connector/api/v1/web-orders
GET
/connector/api/v1/web-orders/en-curso
POST
/connector/api/v1/web-orders/{id}/accept
POST
/connector/api/v1/web-orders/{id}/reject
variation
1 endpoint ▾
GET
/connector/api/variation/{id?}
variation-template
2 endpoints ▾
GET
/connector/api/variation-template
POST
/connector/api/variation-template
web-orders
4 endpoints ▾
GET
/connector/api/web-orders
GET
/connector/api/web-orders/en-curso
POST
/connector/api/web-orders/{id}/accept
POST
/connector/api/web-orders/{id}/reject
💻

Ejemplos curl

Copy & paste para empezar

1. Pedir token:

curl -X POST 'https://app.micdepos.com/oauth/token' \
  -H 'Content-Type: application/json' \
  -d '{
    "grant_type": "password",
    "client_id": "",
    "client_secret": "",
    "username": "",
    "password": "",
    "scope": "*"
}'

2. Listar contactos:

curl 'https://app.micdepos.com/connector/api/contactapi' \
  -H 'Authorization: Bearer ' \
  -H 'Accept: application/json'

3. Crear una venta (POS):

curl -X POST 'https://app.micdepos.com/connector/api/sell' \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
    "location_id": 1,
    "transaction_date": "2026-04-28 12:00:00",
    "contact_id": 1,
    "products": [
      { "variation_id": 1, "quantity": 2, "unit_price": 10000 }
    ],
    "payments": [
      { "amount": 20000, "method": "cash" }
    ]
}'

4. Crear un producto con la foto por link:

curl -X POST 'https://app.micdepos.com/connector/api/product' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Zapatilla running",
    "sku": "7790001234567",
    "unit_id": 1,
    "tax_id": 1,
    "single_dpp": 120000,
    "single_dsp": 180000,
    "image_url": "https://tu-proveedor.com/fotos/zapatilla.jpg"
}'

Sobre image_url

  • Tiene que ser el link directo a la imagen, no el de la página del producto. Un link que devuelve HTML se rechaza.
  • La descarga la hace el servidor: http o https, hasta 5 MB, formatos JPG, PNG, GIF o WEBP.
  • El archivo se valida por su contenido, no por la extensión del link.
  • Si en el mismo pedido mandás la imagen como archivo (multipart, campo image), gana el archivo y el link se ignora.
  • Sirve igual en PUT /product/{id} para reemplazar la foto de un producto que ya existe.
  • Si el link falla, la respuesta es 422 con el motivo en message (por ejemplo: «Ese link no es una imagen»), y el producto no se crea.

Por seguridad solo se aceptan direcciones de internet: un link que apunte a la red interna del servidor (localhost, 10.x, 192.168.x, 169.254.x) se rechaza, incluso si se llega a él a través de una redirección.

⚠️

Códigos de error

Respuestas HTTP estándar
Código Significado Acción
200OKListo, procesá la respuesta JSON
201CreadoEl recurso (venta, contacto…) se creó
400Bad RequestRevisá el JSON enviado, falta un campo o tiene formato inválido
401UnauthorizedEl token expiró o es inválido — pedí uno nuevo
403ForbiddenTu user API no tiene permiso para esa operación
404Not FoundEl recurso solicitado no existe en este negocio
422UnprocessableValidación falló — la respuesta detalla qué campos
500Server ErrorError del sistema — contactá al admin