Docs
Powered by

# Correo Argentino

# 1. Listar sucursales

GET /api/subsidiary

El método devuelve un listado de las sucursales.

REQUEST

Los campos van en el header.

  • provider: CorreoArgentino.

  • user: (Tipo de dato: string). Id de agreement . Campo obligatorio.

  • apiKey: (Tipo de dato: string). Api Key. Campo obligatorio.

  • provincia: (Tipo de dato: string). Código de provincia. Ver Código de provincias según la regla ISO 3166-2 (https://es.wikipedia.org/wiki/ISO_3166-2:AR). Campo obligatorio.

provider: CorreoArgentino
user: 18017
apiKey: Apikey eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJTRUxMRVIxODAxNyIsIkNMQUlNX1RPS0VOIjoiUEVSTUlTU0lPTl9ERUZBVUxUIiwiaWF0IjoxNjgwMTMyNjU3LCJpc3MiOiJJU1NVRVIifQ.8zxCNbIB3SE6ip0gm6durApyCuPb9bqcOk_mjgp3DxU
provincia: AR-J

RESPONSE

Devuelve un array de las sucursales disponibles para enviar el pedido.

[
     {
        "location": {
            "geolocation": {
                "latitude": "-34.6927838",
                "longitude": "-58.4832769"
            },
            "country_name": "Argentina",
            "state_name": "BUENOS AIRES",
            "city_name": "VILLA CELINA",
            "city_id": "B0073",
            "neighborhood_name": "LA MATANZA",
            "street_name": "RIVERA",
            "street_number": "2407",
            "zip_code": "B2701ZAA"
        },
        "status": null,
        "schedule": "LUN A VIE 09.00 A 16.00",
        "owner": "VICENTE GONZALO EZEQUIEL",
        "email": "sopoficina@correoargentino.com.ar",
        "phone": "(011) 4462-3631",
        "agency_id": "BBA",
        "agency_name": "VILLA CELINA",
        "package_reception": true,
        "pickup_availability": true,
        "open_hours": {
            "monday": null,
            "tuesday": null,
            "wednesday": null,
            "thursday": null,
            "friday": null,
            "saturday": null,
            "sunday": null,
            "holidays": null
        },
        "last_updated": null,
        "deactivation_date": null,
        "volumetric_capacity": null,
        "maximum_package_dimensions": {
            "height": null,
            "length": null,
            "width": null,
            "weight": null
        }
    }
]

# 2. Generar Envío / Logística inversa

POST /api/shipping/create

El método permite generar un envío.

REQUEST

# provider_data

  • provider: (Tipo de dato: string). Nombre del OOLL (CorreoArgentino). Campo obligatorio.

  • USER: (Tipo de dato: string). Id de Agreement. Campo obligatorio.

  • API_KEY: (Tipo de dato: string). Api key provista por Correo Argentino. Campo obligatorio.

# shippment_data

  • destino.sucursal.id: (Tipo de dato: string). Código de sucursal obtenido en "Listar sucursales". No es obligatorio si se envía "modalidad_envio" en "homeDelivery" Campo obligatorio.

  • destino.postal.calle: (Tipo de dato: string). Campo obligatorio.

  • destino.postal.numero:(Tipo de dato: string). Campo obligatorio.

  • destino.postal.piso:(Tipo de dato: string). Campo opcional.

  • destino.postal.departamento:(Tipo de dato: string). Campo opcional.

  • destino.postal.localidad: (Tipo de dato: string). Nombre de la ciudad de destino. Campo obligatorio.

  • destino.postal.region: (Tipo de dato: string). Código de provincia. Ver al final. Campo obligatorio.

  • destino.postal.codigoPostal: (Tipo de dato: string). Código Postal de la ciudad de destino. Campo obligatorio.

  • destinatario.nombreCompleto: (Tipo de dato: string). Campo obligatorio.

  • destinatario.email:(Tipo de dato: string). Campo opcional.

  • destinatario.telefonos: (Tipo de dato: string). Campo opcional.

  • origen.postal.codigoPostal: (Tipo de dato: string). Campo obligatorio.

  • origen.postal.calle: (Tipo de dato: string). Campo obligatorio.

  • origen.postal.numero: (Tipo de dato: string). Campo obligatorio.

  • origen.postal.localidad: (Tipo de dato: string). Campo obligatorio.

  • origen.postal.region: (Tipo de dato: string). Código de provincia. Ver al final, Campo obligatorio.

  • origen.postal.pais: (Tipo de dato: string). Campo obligatorio.

  • origen.postal.piso: (Tipo de dato: string). Campo obligatorio.

  • origen.postal.departamento: (Tipo de dato: string). Campo obligatorio.

  • remitente.nombreCompleto: (Tipo de dato: string). Campo obligatorio.

  • remitente.email: (Tipo de dato: string). Campo opcional.

  • remitente.telefonos: (Tipo de dato: string). Campo opcional.

  • modalidad_envio: (Tipo de dato: string) Tipo de servicio. Campo obligatorio. Opciones:

    • "agency" (sucursal)
    • "locker" (servicio de locker)
    • "homeDelivery" (domicilio)

  • type: (Tipo de dato: string) Deberá ir "return" si se trata de una devolución. Este atributo se utiliza para invertir los campos origen/destino. Campo obligatorio para devoluciones.

  • tipoServicio: (Tipo de dato: string) Calidad del servicio. Los valores son "CP" si es clásico "EP" si es expreso.

  • bultos.kilos: (Tipo de dato: string). Peso en gramos. Acepta un máximo de 5 dígitos numéricos (99999) obligatorio.

  • bultos.largoCm: (Tipo de dato: string). En cm. Campo opcional.

  • bultos.altoCm: (Tipo de dato: string). En cm. Campo opcional.

  • bultos.anchoCm: (Tipo de dato: string). En cm. Campo opcional.

  • bultos.valorDeclaradoConImpuestos: (Tipo de dato: string). Campo Obligatorio.

  • bultos.detalle: (Tipo de dato: string). Descripción del producto Campo Obligatorio.

  • bultos.idCliente: (Tipo de dato: string). Número de orden asociada al envío. Campo obligatorio.

{
    "provider_data": {
        "provider": "CorreoArgentino",
        "API_KEY": "Apikey eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJTRUxMRVIxODAxNyIsIkNMQUlNX1RPS0VOIjoiUEVSTUlTU0lPTl9ERUZBVUxUIiwiaWF0IjoxNjgwMTMyNjU3LCJpc3MiOiJJU1NVRVIifQ.8zxCNbIB3SE6ip0gm6durApyCuPb9bqcOk_mjgp3DxU",
        "USER": "18017"
    },
    "shippment_data": {
        "origen": {
            "postal": {
                "codigoPostal": "1407",
                "calle": "Cortina",
                "numero": "120",
                "piso": "2",
                "departamento": "C",
                "localidad": "CABA",
                "region": "C",
                "pais": "Argentina",
                "entreCalle": ""
            }
        },
        "fecha_alta": "",
        "tipoServicio": "CP",
        "tipo_paquete": "",
        "id_externo": "",
        "modalidad_envio": "homeDelivery",
                              
        "direccion_envio": "", 
                                                                         
        "correo": "", 
        "currency": "", 
        "type": "return",
        "flow": "",
        "destino": {
            "sucursal": {
                "id": ""
            },
            "postal": {
                "codigoPostal": "1025",
                "calle": "Av Callao",
                "numero": "1756",
                "piso": "2",
                "departamento": "C",
                "localidad": "C",
                "region": "C",
                "pais": "Argentina",
                "entreCalle": ""
            }
        },
        "remitente": {
            "nombreCompleto": "Alberto Lopez",
            "email": "remitente@andreani.com",
            "documentoTipo": "DNI",
            "documentoNumero": "33111222",
            "telefonos": "113332244"
        },
        "destinatario": {
            "nombreCompleto": "Juana Gonzalez",
            "email": "destinatario@andreani.com",
            "documentoTipo": "DNI",
            "documentoNumero": "33999888",
            "telefonos": "1112345678"
        },
        "productoAEntregar": "Aire Acondicionado",
        "bultos": {
            "kilos": 2,
            "largoCm": 10,
            "altoCm": 50,
            "anchoCm": 10,
            "volumenCm": 5000,
            "valorDeclaradoSinImpuestos": 1200,
            "valorDeclaradoConImpuestos": 1452,
            "detalle": "Secador de pelo",
            "idCliente": "98756"
        }
    }
}

RESPONSE

  • numeroDeEnvio: Número de orden. Se utiliza para la obtención de etiqueta y el tracking (Estado de envío).
{
    "response": "Success",
    "providerStatus": "Creado",
    "numeroDeEnvio": "18017506A4I9EC1701",
    "sucursalDeDistribucion": {
        "id": null,
        "descripcion": ""
    },
    "sucursalDeRendicion": null,
    "sucursalDeImposicion": null,
    "numeroDePermisionaria": null,
    "descripcionServicio": "",
    "etiqueta": ""
}

# 3. Cancelar envío

GET /api/shipping/cancel/:id

MÉTODO NO DISPONIBLE POR EL MOMENTO

El método permite cancelar un envío, pero debe ser utilizado inmediatamente después de generado el envío correspondiente. Después de pasado cierto tiempo (no precisado) el método no tendrá efecto.

REQUEST

  • id: Número de envío obtenido en "Generar envío". Va en el id de la url como ruta parametrizada. Campo obligatorio.

Todos estos campos van en el header:

  • provider: CorreoArgentino.

  • user: (Tipo de dato: string). Id de agreement . Campo obligatorio.

  • apiKey: (Tipo de dato: string). Api Key. Campo obligatorio.

provider: CorreoArgentino
user: 18017
apiKey: Apikey eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJTRUxMRVIxODAxNyIsIkNMQUlNX1RPS0VOIjoiUEVSTUlTU0lPTl9ERUZBVUxUIiwiaWF0IjoxNjgwMTMyNjU3LCJpc3MiOiJJU1NVRVIifQ.8zxCNbIB3SE6ip0gm6durApyCuPb9bqcOk_mjgp3DxU

RESPONSE

  • success: Si el valor es true indica que la cancelación fue exitosa.

  • description: decripción de la cancelación con tracking number.

{
    "response": "Success",
    "numeroDeEnvio": "180179GI9852ECC801",
    "description": "Tracking Number: 180179GI9852ECC801 – Description: Pedido Cancelado - No fue impuesto"
}

# 4. Obtener etiqueta

GET /api/shipping/etiqueta/:id

Se emplea para rastrear obtener la url de la etiqueta.

REQUEST

  • id: Número de envío obtenido en "Generar envío". Va en el id de la url como ruta parametrizada. Campo obligatorio.

Todos estos campos van en el header:

  • provider: CorreoArgentino.

  • user: (Tipo de dato: string). Id de agreement . Campo obligatorio.

  • apiKey: (Tipo de dato: string). Api Key. Campo obligatorio.

  • format: (Tipo de dato: string). Formatos de etiqueta. Los valores posibles son: "10x15" o "label". Campo obligatorio.

provider: CorreoArgentino
user: 18017
apiKey: Apikey eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJTRUxMRVIxODAxNyIsIkNMQUlNX1RPS0VOIjoiUEVSTUlTU0lPTl9ERUZBVUxUIiwiaWF0IjoxNjgwMTMyNjU3LCJpc3MiOiJJU1NVRVIifQ.8zxCNbIB3SE6ip0gm6durApyCuPb9bqcOk_mjgp3DxU
format:10x15

RESPONSE

Devuelve la etiqueta en formato base 64.

# 5. Obtener tracking (Estado de envío)

GET /api/shipping/:id

Se emplea para rastrear el envío y obtener su status.

REQUEST

  • id: Número de envío obtenido en "Generar envío". Va en el id de la url como ruta parametrizada. Campo obligatorio.

Todos estos campos van en el header:

  • provider: CorreoArgentino.

  • user: (Tipo de dato: string). Id de agreement . Campo obligatorio.

  • apiKey: (Tipo de dato: string). Api Key. Campo obligatorio.

provider: CorreoArgentino
user: 18017
apiKey: Apikey eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJTRUxMRVIxODAxNyIsIkNMQUlNX1RPS0VOIjoiUEVSTUlTU0lPTl9ERUZBVUxUIiwiaWF0IjoxNjgwMTMyNjU3LCJpc3MiOiJJU1NVRVIifQ.8zxCNbIB3SE6ip0gm6durApyCuPb9bqcOk_mjgp3DxU

RESPONSE

  • providerStatus: Código del estado del envío.
{
    "response": "Success",
    "providerStatus": "Ingresado",
    "numeroDeEnvio": "180179GI9852ECC801",
    "sucursalDeDistribucion": {
        "id": null,
        "descripcion": null
    },
    "sucursalDeRendicion": null,
    "sucursalDeImposicion": null,
    "numeroDePermisionaria": null,
    "descripcionServicio": ""
}

CÓDIGOS DE PROVINCIAS PARA ENVÍO:

{ "A": "Salta", "B": "Provincia de Buenos Aires", "C": "Ciudad Autónoma de Buenos Aires", "D": "San Luis", "E": "Entre Ríos", "F": "La Rioja", "G": "Santiago del Estero", "H": "Chaco", "J": "San Juan", "K": "Catamarca", "L": "La Pampa", "M": "Mendoza", "N": "Misiones", "P": "Formosa", "Q": "Neuquén", "R": "Río Negro", "S": "Santa Fe", "T": "Tucumán", "U": "Chubut", "V": "Tierra del Fuego", "W": "Corrientes", "X": "Córdoba", "Y": "Jujuy", "Z": "Santa Cruz" }

© Copyright 2025. All rights reserved.