Consultar Puntos de Emisión

Consultar Puntos de Emisión

Pruebas

Dominio: https://test-api-factura.edw-dev.com

Producción

Dominio: https://api-financiero.e-dinky.com

Información General

• Endpoint: GET /api/v1/companies/accounts/establishments/emission-points/:companyId/:accountId/:establishmentNo
• Método: GET
• Autenticación: Bearer Token requerido
• Descripción: Consulta los puntos de emisión asociados a un establecimiento específico

Headers Requeridos

Authorization: Bearer {token}
Accept: application/json

Parámetros de URL

Parámetro	Tipo	Requerido	Descripción
companyId	string	Sí	ID de la empresa (RUC)
accountId	string	Sí	ID de la cuenta empresarial
establishmentNo	string	Sí	Número del establecimiento (ej: “001”)

Parámetros de Query (Opcionales)

Parámetro	Tipo	Descripción
page	integer	Número de página (por defecto: 1)
per_page	integer	Elementos por página (por defecto: 25)

Ejemplo de Request

GET /api/v1/companies/accounts/establishments/emission-points/1359194914/509636719/001
Authorization: Bearer {token}
Accept: application/json

Respuesta Exitosa (200 OK)

{
    "message": "Lista de valores",
    "status": "OK",
    "payload": {
        "items": [
            {
                "pto_emision": "001",
                "establishment": "001",
                "name": "Caja Principal",
                "description": "Punto de emisión principal del establecimiento",
                "status": "active",
                "created_at": "2024-01-15T10:30:00Z"
            },
            {
                "pto_emision": "002",
                "establishment": "001",
                "name": "Caja Secundaria",
                "description": "Punto de emisión secundario",
                "status": "active",
                "created_at": "2024-01-20T14:45:00Z"
            },
            {
                "pto_emision": "003",
                "establishment": "001",
                "name": "Caja Express",
                "description": "Punto de emisión para ventas rápidas",
                "status": "active",
                "created_at": "2024-02-01T09:15:00Z"
            }
        ],
        "count_items": 3,
        "current_page": 1,
        "number_paginate": 25,
        "last_page": 1
    }
}

Respuesta de Error (404 Not Found)

{
    "message": "Establecimiento no encontrado",
    "status": "ERROR",
    "payload": null,
    "error": "Establishment not found"
}

Ejemplos de Código

cURL

curl -X GET \
  {{apiFacEcDev}}/api/v1/companies/accounts/establishments/emission-points/1359194914/509636719/001 \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {{bearerToken}}'

Laravel PHP

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'Authorization' => 'Bearer ' . $bearerToken,
    'Accept' => 'application/json',
])->get("{{apiFacEcDev}}/api/v1/companies/accounts/establishments/emission-points/{$companyId}/{$accountId}/{$establishmentNo}");

$emissionPoints = $response->json();

JavaScript

const getEmissionPoints = async (companyId, accountId, establishmentNo) => {
    try {
        const response = await fetch(`{{apiFacEcDev}}/api/v1/companies/accounts/establishments/emission-points/${companyId}/${accountId}/${establishmentNo}`, {
            method: 'GET',
            headers: {
                'Authorization': `Bearer ${bearerToken}`,
                'Accept': 'application/json'
            }
        });

        const data = await response.json();
        return data;
    } catch (error) {
        console.error('Error:', error);
    }
};

Estructura de Respuesta

Campos del Punto de Emisión

Campo	Tipo	Descripción
pto_emision	string	Código del punto de emisión (001, 002, etc.)
establishment	string	Código del establecimiento al que pertenece
name	string	Nombre descriptivo del punto de emisión
description	string	Descripción detallada del punto de emisión
status	string	Estado del punto de emisión (active/inactive)
created_at	string	Fecha de creación en formato ISO 8601

Casos de Uso

📋 Gestión de Puntos de Emisión

• Listar todos los puntos de emisión de un establecimiento
• Verificar estados de puntos de emisión
• Seleccionar punto de emisión para facturación

🏪 Configuración de Cajas

• Configurar múltiples cajas registradoras
• Asignar puntos de emisión específicos
• Organizar flujos de trabajo por punto de emisión

📊 Control Operativo

• Monitorear actividad por punto de emisión
• Gestionar capacidad de emisión
• Optimizar distribución de carga

Notas Importantes

• Formato: Los códigos de punto de emisión siguen el formato SRI (001, 002, etc.)
• Jerarquía: Los puntos de emisión pertenecen a un establecimiento específico
• Estados: Solo se muestran puntos de emisión activos por defecto
• Paginación: Los resultados están paginados para mejor rendimiento
• Permisos: Requiere acceso a la cuenta empresarial y establecimiento específicos