POST
/companies/v1/Crear Compañía
El endpoint /companies/v1/ te permite crear una nueva compañía en nuestra base de datos.
Consideraciones generales
Para el campo operation_country esperamos un código de 3 caracteres respetando el estándar ISO
3166 alpha-3.
Dejamos una lista de ejemplos:
- ARG
- BRA
- CHL
- COL
- MEX
- PER
| Tipo de Empresa | Descripción | País |
|---|---|---|
| COOP | Sociedad Cooperativa. | Brasil |
| ME | Microempresa. | Brasil |
| MEI | Microempreendedor Individual. | Brasil |
| EI | Empresario Individual. | Brasil |
| SCP | Sociedad en cuenta de Participación. | Brasil |
| SLU | Sociedad Limitada Unipersonal. | Brasil |
| EIRELI | Empresa Individual de Responsabilidad Limitada. | Brasil |
| SS | Sociedad Simplificada. | Brasil |
| LTDA | Sociedad de Responsabilidad Limitada. | Brasil |
| EPP | Empresa de Pequeño Porte. | Brasil |
| DEMAIS | Otras empresas. | Brasil |
| SA | Sociedad Anónima. | Argentina |
| SRL | Empresa con responsabilidad limitada. | Argentina |
| SAS | Sociedad por Acciones Simplificada. | Argentina |
| SELF_COMPANY | Empresa unipersonal. | Argentina |
| RI | Responsable Inscripto. | Argentina |
| SELF_EMPLOYED | Monotribustista. | Argentina |
| SH | Sociedad en Comandita Simple. | Argentina |
| CAP_ISECC\IV | Sociedad de Capital e Industria Sección IV. | Argentina |
| SIMPLE_SOC | Sociedad Simple. | Argentina |
| SAU | Sociedad Anónima Unipersonal. | Argentina |
| SGR | Sociedad de Garantía Recíproca. | Argentina |
| ESCROW | Fideicomiso. | Argentina |
| CONSORTIUM | Consorcio. | Argentina |
| COOPERATIVE | Cooperativa. | Argentina |
| CIVIL_SOCIETY | Sociedad Civil. | Argentina |
| CIVIL_ASSOCIATION | Asociación Civil. | Argentina |
| SACIFIA | Sociedad Anónima con Participación Estatal Mayoritaria. | Argentina |
| SA | Sociedad Anónima. | Colombia |
| LTDA | Sociedad Limitada. | Colombia |
| SAS | Sociedad por Acciones Simplificadas. | Colombia |
| SCS | Sociedad en Comandita Simple. | Colombia |
| SCA | Sociedad en Comandita por Acciones. | Colombia |
| SCOL | Sociedad Colectiva. | Colombia |
| EU | Empresa Unipersonal. | Colombia |
| SC | Sociedad Civil. | Colombia |
| COOP | Cooperativa. | Colombia |
| ESAL | Entidad Sin Ánimo de Lucro. | Colombia |
| EAT | Empresa Asociativa de Trabajo. | Colombia |
| SA | Sociedad Anónima. | Perú |
| SRL | Sociedad Comercial de Responsabilidad Limitada. | Perú |
| SGR | Sociedad de Garantía Recíproca. | Perú |
| SS | Sociedad Simple. | Perú |
| SCS | Sociedad en Comandita Simple. | Perú |
| SCA | Sociedad en Comandita por Acciones. | Perú |
| SC | Sociedad Colectiva. | Perú |
| EIRL | Empresa Individual de Responsabilidad Limitada. | Perú |
| SAA | Sociedad Anónima Abierta. | Perú |
| SAC | Sociedad Anónima Cerrada. | Perú |
| COOP | Cooperativa. | Perú |
| SCIVIL | Sociedad Civil Ordinaria. | Perú |
| SCIVILDRL | Sociedad Civil de Responsabilidad Limitada. | Perú |
| SA | Sociedad Anónima. | México |
| SRL | Sociedad de Responsabilidad Limitada. | México |
| SACV | Sociedad Anónima de Capital Variable. | México |
| SRLCV | Sociedad de Responsabilidad Limitada de Capital Variable. | México |
| SAS | Sociedad por Acciones Simplificada. | México |
| SAB | Sociedad Anónima Bursátil. | México |
| SCS | Sociedad en Comandita Simple. | México |
| SCA | Sociedad en Comandita por Acciones. | México |
| SNC | Sociedad en Nombre Colectivo. | México |
| COOP | Sociedad Cooperativa. | México |
| SAPI | Sociedad Anónima Promotora de Inversión. | México |
| AC | Asociación Civil. | México |
| IAP | Institución de Asistencia Privada. | México |
| SA | Sociedad Anónima. | Chile |
| LTDA | Sociedad de Responsabilidad Limitada. | Chile |
| SAS | Sociedad por Acciones Simplificada. | Chile |
| SAGR | Sociedad Anónima de Garantía Recíproca. | Chile |
| SCS | Sociedad en Comandita Simple. | Chile |
| SCA | Sociedad en Comandita por Acciones. | Chile |
| SC | Sociedad Colectiva. | Chile |
| EIRL | Empresa Unipersonal. | Chile |
| SCV | Sociedad Civil. | Chile |
| COOP | Sociedad Cooperativa. | Chile |
| SCC | Sociedad Colectiva Comercial. | Chile |
Consideraciones sobre los documentos fiscales a utilizar
Brasil: El tipo de documento fiscal aceptado es el CNPJ.
Argentina: El tipo de documento fiscal aceptado es el CUIT. Campos requeridos: legal_address, email, trade_name, legal_name, phone, type, tax_condition, tax_identification_type, tax_identification_value
Parámetros disponibles
Header Parameters
AuthorizationStringrequired
x-idempotency-keyStringrequired
Cuerpo de solicitud
application/jsonlegal_namestring
trade_namestring
tax_identification_typeenum
tax_identification_valuestring
emailstring
phonestring
operation_countrystringrequired
typeenum
legal_addressobject10 propiedades
tax_conditionenum
Detalle de respuestas
401
No autorizado
Ejemplo de solicitud
{
"legal_name": "Pomelo SAS",
"trade_name": "Pomelo",
"tax_identification_type": "CNPJ",
"tax_identification_value": "43.856.175/0001-08",
"email": "[email protected]",
"phone": "1123456789",
"operation_country": "ARG",
"type": "MEI",
"legal_address": {
"street_name": "Av. Corrientes",
"street_number": 300,
"floor": 1,
"apartment": "A",
"zip_code": 1414,
"neighborhood": "Villa Crespo",
"city": "CABA",
"region": "Buenos Aires",
"additional_info": "Torre 2",
"country": "ARG"
},
"tax_condition": "VAT_REGISTERED"
}Ejemplo de código
curl -X POST "https://api.pomelo.la/companies/v1/" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-idempotency-key: fRwX12Dg3345AD" \
-d '{
"legal_name": "Pomelo SAS",
"trade_name": "Pomelo",
"tax_identification_type": "CNPJ",
"tax_identification_value": "43.856.175/0001-08",
"email": "[email protected]",
"phone": "1123456789",
"operation_country": "ARG",
"type": "MEI",
"legal_address": {
"street_name": "Av. Corrientes",
"street_number": 300,
"floor": 1,
"apartment": "A",
"zip_code": 1414,
"neighborhood": "Villa Crespo",
"city": "CABA",
"region": "Buenos Aires",
"additional_info": "Torre 2",
"country": "ARG"
},
"tax_condition": "VAT_REGISTERED"
}'Ejemplo de respuesta (201)Compañía creada
{
"data": {
"id": "cmp-2E5eUyw1ZolEj1Y3NHxnob7bFZe",
"legal_name": "Pomelo SAS",
"trade_name": "Pomelo",
"tax_identification_type": "CNPJ",
"tax_identification_value": "43.856.175/0001-08",
"email": "[email protected]",
"phone": "1123456789",
"operation_country": "ARG",
"type": "MEI",
"status": "ACTIVE",
"legal_address": {
"street_name": "Av. Corrientes",
"street_number": 300,
"floor": 1,
"apartment": "A",
"zip_code": 1414,
"neighborhood": "Villa Crespo",
"city": "CABA",
"region": "Buenos Aires",
"additional_info": "Torre 2",
"country": "ARG"
}
}
}