{"id":36986354,"url":"https://github.com/gento-arg/magento-oca","last_synced_at":"2026-01-13T23:04:18.175Z","repository":{"id":45112497,"uuid":"231872933","full_name":"gento-arg/magento-oca","owner":"gento-arg","description":"Metodo de envio por OCA para Magento 2","archived":false,"fork":false,"pushed_at":"2025-07-20T00:14:36.000Z","size":220,"stargazers_count":4,"open_issues_count":2,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-05T16:13:09.293Z","etag":null,"topics":["magento2-module","module-shipping","oca","oca-epak"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gento-arg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":"https://cafecito.app/gento"}},"created_at":"2020-01-05T05:38:38.000Z","updated_at":"2025-07-20T00:14:04.000Z","dependencies_parsed_at":"2024-07-22T18:11:54.175Z","dependency_job_id":null,"html_url":"https://github.com/gento-arg/magento-oca","commit_stats":{"total_commits":61,"total_committers":4,"mean_commits":15.25,"dds":0.09836065573770492,"last_synced_commit":"7fc6d4681f1ae2a423ecac4f3bb0279386f0474d"},"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/gento-arg/magento-oca","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gento-arg%2Fmagento-oca","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gento-arg%2Fmagento-oca/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gento-arg%2Fmagento-oca/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gento-arg%2Fmagento-oca/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gento-arg","download_url":"https://codeload.github.com/gento-arg/magento-oca/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gento-arg%2Fmagento-oca/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28405129,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T21:51:37.118Z","status":"ssl_error","status_checked_at":"2026-01-13T21:45:14.585Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["magento2-module","module-shipping","oca","oca-epak"],"created_at":"2026-01-13T23:04:18.097Z","updated_at":"2026-01-13T23:04:18.159Z","avatar_url":"https://github.com/gento-arg.png","language":"PHP","funding_links":["https://cafecito.app/gento"],"categories":[],"sub_categories":[],"readme":"# Magento 2 shipping method for OCA\n\n# Tabla de contenido\n\n* [Instalación](#Instalación)\n* [Configuración](#Configuración)\n    * [Tienda](#Configuración-de-tienda)\n    * [Método](#Configuración-de-método-de-envío)\n    * [Operatorias](#Operatorias)\n* [GraphQL](#GraphQL)\n* [Desinstalar](#Desinstalar)\n* [Contributing](#Contributing)\n\nEste módulo permite utilizar [OCA E-Pak](https://www.oca.com.ar/ecommerce_epak_epak/) como un método de envío en Magento\n2\n\n## Instalación\n\nUsar [composer](https://getcomposer.org/) para instalar Gento_Oca.\n\n```\ncomposer require gento-arg/module-oca\n```\n\nLuego, es necesario activar el módulo y actualizar la base de datos.\n\n```\nbin/magento module:enable Gento_Oca\nbin/magento setup:upgrade\nbin/magento cache:clean\n```\n\n## Configuración\n\n### Configuración de tienda\n\nEste paso sólo es requerido en caso de querer generar las etiquetas de envío. En el menú `Stores -\u003e Configuration`, en\nla sección `General -\u003e General` y el grupo`Store information`, es requerido completar los siguientes campos:\n\n- Store name\n- Store phone number\n\nLuego, en la sección `Sales -\u003e Shipping Settings`, en el grupo `Origin`:\n\n- Street address\n- City\n- Zip/Postal code\n- Country\n\n### Configuración de método de envío\n\nEn las configuraciónes de métodos de envío, sección `Sales -\u003e Shipping Methods` o `Sales -\u003e Delivery methods`\ndependendienddo la versión de Magento, OCA utililza el `CUIT` para identificar a sus clientes a fin de validar los\ncontratos y estimar los costos de envío. A continuación se explican los diferentes campos de configuración:\n\n- **CUIT:** (*) Dato del titular del contrato.\n- **Titulo:** Es el titulo que aparecerá junto a las diferentes operatorias en el checkout y en la información de envío.\n- **Account number:** (**) Es un numero de cuenta que provee OCA como parte del contrato de ePak.\n- **Username:** (**) Usuario de ePak.\n- **Password:** (**) Password de ePak.\n- **Days to send:** Días para informarle a OCA al momento de generar la orden de retiro.\n- **Days to send (Extra):** Estos días no serán informados a OCA pero se visualizarán en el carro en caso de\n  que `Show days to send` esté activado.\n- **Show days to send:** En caso de activarse, además del nombre del método de envío se le informará al cliente el\n  tiempo en el paquete será despachado.\n- **Reception time:** Rango horario en el que OCA debe realizar el\n- **Confirm:** En caso de estar en `No`, la orden de retiro debe confirmarse desde el panel de OCA.\n- **Disabled Postal codes:** En caso de necesitar deshabilitar ciertos códigos postales, se pueden listar en este campo,\n  uno por línea.\n- **Branch description:** En formato de template, indica la información que debería verse en el pedido en caso de\n  seleccionar retiro en sucursal.\n- **Oep WebService URL:** URL para comunicarse con servicios\n  OEP. `http://webservice.oca.com.ar/oep_tracking_test/Oep_Track.asmx` para test\n  y `http://webservice.oca.com.ar/oep_tracking/Oep_Track.asmx` para producción.\n- **Epak WebService URL:** URL para comunicarse con servicios de\n  ePak. `http://webservice.oca.com.ar/epak_tracking_test/Oep_TrackEPak.asmx` para test\n  y `http://webservice.oca.com.ar/epak_tracking/Oep_TrackEPak.asmx` para producción.\n- **Tracking URL:** Ésta URL será a la que se le concatenará el número de seguimiento para rastreo. Por\n  defecto: `https://www5.oca.com.ar/ocaepakNet/Views/ConsultaTracking/TrackingConsult.aspx?numberTracking=`. Tener en\n  cuenta que OCA suele cambiar esta URL.\n- **Min box volume:** Para calcular los costos de envío, OCA requiere que se le indique el volumen de lo que se va a\n  enviar, en caso de no tener atributos en los productos con los que se pueda calcular el volumen, se utilizará este\n  valor. Dependiendo el contrato con OCA puede que este valor no sea necesario y se utilice el peso.\n- **Product (width|height|length) attribute:** Atributo del producto que se utilizará para calcular el volumen.\n- **Unit product attribute:** Unidad de medida en la que está expresada la dimensión del producto.\n\n_* Valor requerido para el cálculo de costo de envío_\n\n_** Valor requerido para impresión de etiquetas_\n\n### Operatorias\n\nEn el menú `GENTo -\u003e Operatories` se deben agregar las operatorias con las que se desea trabajar.\n\n#### Campos\n\n* **Name**: Este es el título que verá el cliente para seleccionar.\n* **Code**: Código interno de OCA.\n* **Uses branches**: Indica si la operatoria es de retiro en sucursal.\n* **Pays on destination branch**: En caso de ser positivo, el monto será informado el cliente pero no le generará una\n  deuda.\n\n### Sucursales\n\nLas sucursales se crean automáticamente con una sincronización de cron. Una vez que fueron creadas, es posible\ndeshabilitarlas o incluso cambiar ciertos datos.\n*Atención: Si se cambia el código de la sucursal, puede que no funcione correctamente.*\n\n## GraphQL\n\nUsando el endpoint de graphql es posible filtrar las sucursales por código postal:\n\n```HTTP\npath: /graphql\nmethod: POST\nbody: { \"query\": \"query { ocaBranches ( zipCode: \\\"2000\\\" ) { items { code short_name address_street address_number address_floor address_dpt address_tower telephone email city zipcode servicios branch_description } } }\" }\n```\n\nEsa consulta retorna:\n\n```JSON\n{\n    \"data\": {\n        \"ocaBranches\": {\n            \"items\": [\n                {\n                    \"code\": \"93\",\n                    \"short_name\": \"RO1\",\n                    \"address_street\": \"CORRIENTES\",\n                    \"address_number\": \"746\",\n                    \"address_floor\": \"\",\n                    \"address_dpt\": \"\",\n                    \"address_tower\": \"\",\n                    \"telephone\": \"0341-4496111\",\n                    \"email\": \"\",\n                    \"city\": \"ROSARIO\",\n                    \"zipcode\": \"2000\",\n                    \"servicios\": [\n                        \"1\",\n                        \"2\",\n                        \"3\"\n                    ],\n                    \"branch_description\": \"ROSARIO\\nCORRIENTES 746\\n0341-4496111\\n\"\n                },\n                {\n                    \"code\": \"587\",\n                    \"short_name\": \"D50\",\n                    \"address_street\": \"BOULEVARD BELGRANO\",\n                    \"address_number\": \"1250\",\n                    \"address_floor\": \"\",\n                    \"address_dpt\": \"\",\n                    \"address_tower\": \"\",\n                    \"telephone\": \"03476-15-582392\",\n                    \"email\": \"\",\n                    \"city\": \"TOTORAS\",\n                    \"zipcode\": \"2144\",\n                    \"servicios\": [\n                        \"1\",\n                        \"2\"\n                    ],\n                    \"branch_description\": \"TOTORAS\\nBOULEVARD BELGRANO 1250\\n03476-15-582392\\n\"\n                },\n                {\n                    \"code\": \"595\",\n                    \"short_name\": \"D55\",\n                    \"address_street\": \"SAN MARTIN\",\n                    \"address_number\": \"1482\",\n                    \"address_floor\": \"\",\n                    \"address_dpt\": \"\",\n                    \"address_tower\": \"\",\n                    \"telephone\": \"426-3357\",\n                    \"email\": \"\",\n                    \"city\": \"ROSARIO\",\n                    \"zipcode\": \"2000\",\n                    \"servicios\": [\n                        \"1\",\n                        \"2\"\n                    ],\n                    \"branch_description\": \"ROSARIO\\nSAN MARTIN 1482\\n426-3357\\n\"\n                }\n            ]\n        }\n    }\n}\n```\n\n## Desinstalar\n\n```\nbin/magento module:uninstall Gento_Oca\n```\n\nIf you used Composer for installation Magento will remove the files and database information.\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n\nPlease make sure to update tests as appropriate.\n\n### How to create a PR\n\n1. Fork it\n2. Create your feature branch (git checkout -b my-new-feature)\n3. Commit your changes (git commit -am 'Add some feature')\n4. Push to the branch (git push origin my-new-feature)\n5. Create new Pull Request\n\n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgento-arg%2Fmagento-oca","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgento-arg%2Fmagento-oca","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgento-arg%2Fmagento-oca/lists"}