Documentación

Documentación del API de efacturapty.

POST

/api/v1/Invoices

Servicio para el procesamiento de una factura electrónica en formato JSON

Request body

{
  "datosGenerales": {
    "tipoEmision": "string",
    "fechaHoraInicioContingencia": "2021-12-08T19:47:34.334Z",
    "razonOperacionContingencia": "string",
    "tipoDocumento": "string",
    "numeroDocumento": 0,
    "puntoFacturacion": 0,
    "fechaEmision": "2021-12-08T19:47:34.334Z",
    "fechaSalidaEstimada": "2021-12-08T19:47:34.334Z",
    "naturalezaOperacion": "string",
    "tipoOperacion": 0,
    "destinoOperacion": 0,
    "formatoGeneracionCafe": 0,
    "maneraEntregaCafe": 0,
    "envioContenedorReceptor": 0,
    "procesoGeneracionFe": 0,
    "tipoTransaccionVenta": 0,
    "tipoSucursal": 0,
    "informacionInteresEmisor": "string",
    "informacionEmisor": {
      "datosRucEmisor": {
        "tipoContribuyente": 0,
        "ruc": "string",
        "digitoVerificador": "string"
      },
      "nombreORazonSocial": "string",
      "codigoSucursal": "string",
      "coordenadaGeograficaSucursal": "string",
      "direccionSucursal": "string",
      "ubicacionEmisor": {
        "codigoUbicacion": "string",
        "corregimiento": "string",
        "distrito": "string",
        "provincia": "string"
      },
      "telefonoSucursal": "string",
      "direccionCorreoElectronico": "string"
    },
    "informacionReceptor": {
      "tipoReceptorFe": "string",
      "datosRucReceptor": {
        "tipoContribuyente": 0,
        "rucReceptor": "string",
        "digitoVerificador": "string"
      },
      "nombreRazonReceptor": "string",
      "direccionReceptor": "string",
      "ubicacionReceptor": {
        "codigoUbicacion": "string",
        "corregimiento": "string",
        "distrito": "string",
        "provincia": "string"
      },
      "grupoIdentificacionExtranjera": {
        "pasaportNumeroIdentificacionextranjera": "string",
        "paisExtrangero": "string",
        "telefonoContactoReceptor": "string",
        "correoElectonicoReceptor": "string",
        "paisReceptor": "string",
        "paisReceptorNoExisteDescripcion": "string"
      },
      "telefonoContactoReceptor": "string",
      "correoElectronicoRecepctor": "string",
      "paisReceptor": "string",
      "paisReceptorNoExisteDescripcion": "string"
    },
    "facturaExportacion": {
      "condicionEntregaINCOTERMS": "string",
      "monedaOperacion": "string",
      "descripcionMonedaNoExistente": "string",
      "tipoDeCambio": 0,
      "montoMOnedaExtrangera": 0,
      "puertoEmbarque": "string"
    },
    "documentosFiscalesReferenciados": [
      {
        "rucEmisorDocumentoReferenciado": "string",
        "tipoContribuyenteEmisorDocuemntoReferenciado": 0,
        "rucContribuyenteEmisorDocumentoReferenciado": "string",
        "digitoVerificador": "string",
        "nombreRazonSocialEmisor": "string",
        "fechaEmisionDocumentoReferenciado": "2021-12-08T19:47:34.334Z",
        "informacionReferencia": {
          "informacionReferencia": {
            "cufeReferenciado": "string"
          },
          "informacionReferenciaFacturaPapel": {
            "numeroFacturaPapel": "string"
          },
          "informacionReferenciaImpresoraFiscal": {
            "numeroFeImpresoraFiscal": "string"
          }
        }
      }
    ],
    "grupoAutorizacionDescargaFe": {
      "autorizacionDescargaFe": {
        "tipoContribuyente": 0,
        "ruc": "string",
        "digitoVerificador": "string"
      }
    }
  },
  "listaItems": [
    {
      "numeroSecuenciaItem": 0,
      "descripcionProductoServicio": "string",
      "codigoInternoItem": 0,
      "unidadMedidaCodigoInterno": "string",
      "cantidadProductoServicio": 0,
      "fechaFabricacion": "string",
      "fechaCaducidad": "string",
      "codigoItemCodificacionPanamenaAbreviada": 0,
      "codigoItemCadificacionPanamena": 0,
      "unidadMedidaCodificacionPanamena": "string",
      "imformacionInteresEmisor": "string",
      "grupoPrecios": {
        "precioUnitarioTranferencia": 0,
        "descuento": 0,
        "precioUnitario": 0,
        "precioSeguro": 0,
        "precioAcarreo": 0,
        "sumaPrecioItem": 0
      },
      "grupoOtrosCodigosItem": {
        "codigoGTINComercializacion": 0,
        "cantidadProductoServicioGTINCom": 0,
        "codigoGTINInventario": 0,
        "cantidadProductoServicioCodigoGTIN": 0
      },
      "grupoITBMS": {
        "tasaITBMSAplicable": "string",
        "montoITBMS": 0
      },
      "grupoISC": {
        "tasaISCAplicable": 0,
        "montoISC": 0
      },
      "grupoOtrasTasasImpuesto": [
        {
          "dCodOTI": "string",
          "dValOTI": 0
        }
      ],
      "grupoDetalleVehiculo": {
        "modalidadOperacion": "string",
        "modalidadOperacionNoListada": "string",
        "chasis": "string",
        "color": "string",
        "colorDescripcion": "string",
        "potenciaMotor": 0,
        "capacidadMotor": 0,
        "pesoNeto": 0,
        "pesoBruto": 0,
        "tipoCombustible": "string",
        "tipoCombustibleNoListado": "string",
        "numeroMotor": "string",
        "capacidadMaximaTraccion": 0,
        "distanciaEjes": 0,
        "anioModeloFabricacion": 0,
        "aniofabricacion": 0,
        "tipoPintura": 0,
        "tipoPinturaNoListado": "string",
        "tipovehiculo": 0,
        "usovehiculo": 0,
        "condicionVehiculo": 0,
        "capacidadMaxima": 0
      },
      "grupoDetalleMedicina": {
        "numeroLoteMedicina": 0,
        "catidadProducto": 0
      },
      "grupoDetallePedidoComercial": {
        "numeroPedidoCompra": 0,
        "numeroSecuenciapedido": 0,
        "informacionInteresEmisor": "string"
      }
    }
  ],
  "totales": {
    "tiempoPago": 0,
    "grupoDescuentosBonificaciones": [
      {
        "descripcionDescuentoBonificacion": "string",
        "montoDescuentoBonificacion": 0
      }
    ],
    "grupoFormasPago": [
      {
        "formaPago": "string",
        "formaPagoDescripcion": "string",
        "valorCuotaPagada": 0
      }
    ],
    "grupoRetencionesFactura": {
      "codigoRetencionAplicar": 0,
      "montoRetencionAplicar": 0
    },
    "grupoInformacionPago": [
      {
        "numeroSecuenciaCuota": 0,
        "fechaVencimientoCuota": "string",
        "valorCuota": 0,
        "informacionInteresEmisorCuota": "string"
      }
    ],
    "grupoTotalTasas": [
      {
        "codigoOtrasTasasImpuestos": "string",
        "valorTotalTasasImpuestos": 0
      }
    ]
  },
  "detallePedido": {
    "numeroPermisoCompra": 0,
    "numeroAceptacion": 0,
    "codigoClienteReceptor": "string",
    "codigoSistemaEmisor": "string",
    "informacionInteresEmisor": "string"
  },
  "informacionLogistica": {
    "numeroVolumenes": 0,
    "pesoTotalCarga": 0,
    "unidadPesoTotalCarga": 0,
    "licenciaVehiculo": "string",
    "nombreRazonTransportista": "string",
    "rucTransportista": {
      "tipoContribuyente": 0,
      "ruc": "string",
      "digitoVerificador": "string"
    },
    "informacionInteresEmisor": "string"
  },
  "datosLocal": {
    "datosRucReceptor": {
      "tipoContribuyente": 0,
      "ruc": "string",
      "digitoVerificador": "string",
      "nombreRazonLocal": "string",
      "direccionLocal": "string"
    },
    "nombreRazonLocalEntrega": "string",
    "direccionLocal": "string",
    "grupoUbicacion": {
      "codigoUbicacion": "string",
      "corregimiento": "string",
      "distrito": "string",
      "provincia": "string"
    },
    "telefonoContacto": "string",
    "telofonoContactoAdicional": "string",
    "telefonoContactoLocal": "string"
  },
  "datosFirma": {},
  "ambiente": 0,
  "secuencia": 0,
  "versionFormulario": "string"
}

Respuesta

Valor de ejemplo

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "rRetEnviFe": {
    "dVerForm": "string",
    "iAmb": 0,
    "dVerApl": "string",
    "rProtFe": {
      "dVerForm": 0,
      "gInfProt": {
        "dId": "string",
        "iAmb": 0,
        "dVerApl": "string",
        "dCUFE": "string",
        "dFecProc": "2021-10-07T21:30:32.845Z",
        "dProtAut": "string",
        "dDigVal": "string",
        "gResProc": [
          {
            "dCodRes": "string",
            "dMsgRes": "string"
          }
        ]
      },
      "signature": "string"
    }
  },
  "invoice": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "cufe": "string",
  "secuence": 0,
  "requestTime": 0,
  "createdBy": "string",
  "createdDate": "2021-10-07T21:30:32.845Z",
  "updatedBy": "string",
  "updatedDate": "2021-10-07T21:30:32.845Z",
  "deletedBy": "string",
  "deletedDate": "2021-10-07T21:30:32.845Z"
}

GET

/api/v1/Invoices/{cufe}

Consultar una factura emitida utilizando el CUFE.

cufe

String: CUFE de una factura emitida a través del servicio

Respuesta

Valor de ejemplo

{
  "dVerForm": "string",
  "iAmb": 0,
  "dVerApl": "string",
  "dFecProc": "2021-10-07T21:32:38.567Z",
  "dCodRes": "string",
  "dMsgRes": "string",
  "xContenFE": [
    null
  ],
  "dCUFEAut": "string"
}