Conecta tu sistema con Matika

La API permite crear documentos tributarios electrónicos (facturas, boletas, notas de crédito y otros), registrar clientes, contactos, sucursales y productos, y consultar lo que ya está en Matika. Todas las llamadas usan JSON sobre HTTPS y se autentican con un token OAuth 2.0.

Las rutas de esta página son relativas a . El campo de arriba cambia la URL base y actualiza todos los ejemplos.

Con el client_id, el client_secret y el usuario que Matika le entregó se pide un token:

La respuesta trae access_token y su vigencia en expires_in (segundos). Se envía en cada llamada con el encabezado Authorization:

Si el token falta o venció, el servidor responde 401. Pida uno nuevo y repita la llamada.

• Cuerpos envueltos. Los POST reciben un objeto con una sola propiedad que lleva el nombre del parámetro (por ejemplo {"DteSiiSDT": [ … ]}). Las respuestas también vienen envueltas ({"DtePostResult": [ … ]}).
• El resultado va en el cuerpo, no en el código HTTP. Una operación procesada responde 200 aunque haya fallado. Revise ErrorCode: "99" significa que se grabó; cualquier otro valor es un error y ErrorMessage dice por qué.
• Paginación. Los listados reciben Pagenumber (desde 1) y Pagesize. Una página vacía responde 200 con la lista vacía y un mensaje "No se encontraron registros" en Messages.
• Fechas en formato AAAA-MM-DD. Montos como número, con punto decimal.
• Altas que también actualizan. Clientes, contactos, sucursales y productos se crean si el identificador no existe y se actualizan si ya existe.

Valores de ErrorCode que devuelve POST /Insert, uno por documento enviado. Orden indica a qué documento del arreglo corresponde.

En las altas de clientes, contactos, sucursales y productos, "99" también significa éxito; ante cualquier otro código, lea ErrorMessage.

• Envíe un documento por llamada. /Insert acepta un arreglo, pero con un documento por llamada cada error queda asociado sin ambigüedad a lo que se envió.
• No reintente a ciegas. Si una llamada a /Insert se corta sin respuesta, el documento puede haberse creado igual. Antes de repetirla, búsquelo con /ListDteSii: un reintento con DteSiiFolio = 0 crea un documento nuevo con otro folio.
• Cree primero los maestros. El cliente, su sucursal y los productos deben existir antes de emitir el documento.
• Mensajes largos. ErrorMessage llega truncado a 255 caracteres. Si no alcanza para entender el problema, escriba a soporte con el Orden y la hora de la llamada.