Inicio
Documentación
Recursos
Certificaciones
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

Comunidad

Recibe las últimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Crear acción de la terminal - Impresiones - Mercado Pago Developers
Crear acción de terminal

POST

https://api.mercadopago.com/terminals/v1/actions
Este endpoint permite la creación de una nueva acción de impresión para Mercado Pago Point. En caso de éxito, la requisición devolverá un código de estado 201.
Parámetros para la solicitud
HEADER
X-Idempotency-Key
string

REQUERIDO

Esta función permite repetir solicitudes de manera segura, sin el riesgo de realizar la misma acción más de una vez por error. Esto es útil para evitar errores, como la creación de dos pagos idénticos. Para garantizar qu...Ver más
BODY
type
string

REQUERIDO

Tipo de acción, asociada a la solución de Mercado Pago para la que se crea. En estos momentos, solo se soporta el valor "print".
print: Valor asociado con la creación de acciones de impresión para el Punto de Venta.
external_reference
string

REQUERIDO

Es una referencia externa de la acción, asignada al momento de su creación. El límite máximo permitido es de 64 caracteres y los permitidos son: letras mayúsculas y minúsculas, números y los símbolos de guion (-) y guion...Ver más
config
object

REQUERIDO

Configuración del tipo de acción.
content
string

REQUERIDO

String que contiene la información a imprimir en la terminal Point. Si el subtipo es "invoice", debe ser un .xml válido, y si el subtipo es "custom" debe contener un string formateado con las etiquetas soportadas.
Parámetros de respuesta
id
string
Identificador de la acción creada en la solicitud, generado automáticamente por Mercado Pago.
type
string
Tipo de acción.
print: Acción de impresión creada para Point.
external_reference
string
Es una referencia externa de la acción, asignada al momento de su creación. El límite máximo permitido es de 64 caracteres. Los caracteres permitidos son: letras mayúsculas y minúsculas, números y los símbolos de guion (...Ver más
status
string
Estado actual de la accíon.
created: La accíon ha sido creada de manera exitosa.
Errores

400Error

empty_required_header

El header 'X-Idempotency-Key' es requerido y no fue enviado. Vuelve a realizar la requisición incluyéndolo.

required_properties

Ciertas propiedades requeridas están ausentes. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

unsupported_properties

Se envió una propiedad que no es soportada. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

property_type

Se envió un tipo de propiedad incorrecto. Por ejemplo, un valor 'integer' para una propiedad 'string'. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

property_value

Se envió un valor inválido para alguna propiedad. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

json_syntax_error

Se envió un JSON inválido. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

invalid_data_xml

Los datos enviados en el .xml no cumplen con el formato proporcionado por el emisor de las facturas. Verifica el mensaje devuelto en los detalles del error para averiguar cuál fue el problema e inténtalo nuevamente.

401Error.

unauthorized

El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la requisición enviando el valor correcto.

403Error.

forbidden_checking_terminal_owner

La terminal Point no pertence al usuario que envió la solicitud. Verifica si el valor enviado para "terminal_id" es correcto o si la terminal está vinculado a tu cuenta.

409Error.

idempotency_key_already_used

El valor enviado como header de idempotencia ya fue utilizado con una solicitud distinta en un tiempo menor a 24 horas. Por favor, vuelve a intentar realizar la requisición enviando un nuevo valor.

already_queued_order_for_terminal

La terminal ya tiene una order en espera. Es necesario finalizarla o cancelarla para enviar nuevas orders.

500Error.

idempotency_validation_failed

Falla en la validación. Intenta enviar la solicitud nuevamente.

500

Error genérico. Intenta enviar la solicitud nuevamente.

Solicitud
curl -X POST \
    'https://api.mercadopago.com/terminals/v1/actions'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
    -d '{
  "type": "print",
  "external_reference": "ext_ref_1234",
  "config": {
    "point": {
      "terminal_id": "NEWLAND_N950__N950NCB123456789",
      "subtype": "invoice"
    }
  },
  "content": "{br}--------------------------------{br}{center}{w} COMPROBANTE DE ENTREGA{/w}{br}{br}{s} Nro pedido :12345{/s}{br}{s} Tienda: Tienda de prueba{/s}{br}--------------------------------{br}{s}***ITEM(S) DESPACHO***{/s}{br}{s}SKU / ARTICULO                    CANTIDAD    {/s}{br}{s}----------------------------------------------{/s}{br}{s}4065432630504 / BALON FUTBOL ADIDAS WUCL LGE EHV240424   1{br}{s}ENTREGAR: 06/06/2024{/s}{br}{s}DIRECCION: METROPOLITANA Cerro Navia test 12345  {/s}{br}{s}RECIBE: Pepito Perez{/s}{br}{s}entrega a cliente en horario am{/s}{br}--------------------------------{br}"
}'
Respuesta de ejemplo
{
  "id": "8952c6cf-bbb4-482c-a9f2-ea5fecd3ecd2",
  "type": "print",
  "external_reference": "ext_ref_1234",
  "status": "created",
  "config": {
    "point": {
      "terminal_id": "NEWLAND_N950__N950NCB123456789",
      "subtype": "invoice"
    }
  }
}